~*s 




VIP Disk-ZAP 

Diskette Repair Utility 



Operator's Manual 




ihc TRS-HO Color nmi TDP System J00 P 



c r M 3 T M • > D 



y ... 



VIP Disk-ZAP 

Copyright (Q 1983 

by Softlaw Corporation 

Written by Tim Nelson 






VIP Disk-ZAP Operators Manual 
Copyright (Q 1983 
by Softlaw Corporation 
Written by Tom Nelson 

All Rights Reserved 

Softjvare and Operator; Manual Copyright Notice 

Th$s software and manual are intended for the personal 
use arid pleasure of the purchaser. Both have been 
copyrighted by Softlaw Corporation, and reproduction of 
the software or this manual . or any part thereof by any 
ir- tins is. forbidden without express written permission 
frprij Softlav Corporation. ■ 



VIP Disk-ZAP, VIP' library 

VIP Terminal, VfP Calc 

VIP Writer. VIP Database 

& VIP Speller ' »> 

Are Trademarks of 'Softlaw Corporation. 



Softlaw Corporation 9072 Lyndale Ave. So. 
Muineapolis, Minnesota 55420 612/881-2777 



TABLE OF CONTENTS 

Section Page 

PART I : How the VIP Di sk-ZAP Works 1 

About This Manual 1 

Loading The VIP Disk-ZAP From Diskette 2 

System Requirements . , . 2 

Getting Started 2 

Toggle Conmands : X-Late, Base , arid ASCII 4 

<BREAK>: Exit 6 

File Determination „ . . 7 

<F> Filename ,7 

<A> Directory ........ 8> 

File and Disk Access J.0 

<V> Verify Disk 10 

<R>, <W> Read Sectors/Write Sector i : '. ! i\ r ll 

<F> File Zap . . 1 , . . . i , . , . . . . '12 

File Access Coiimands ,...,..,.,. r : . '. . ','.'. ' '! ' 1'5 

The Screen Display ..... .v. ......;., 16 

The ASCII System. . .*i ,,..,.:;;'. .';'-.'. 17 

<N> Name i . .'.'; .Y. : V. . .'Vv ' 20' 

<A> Directory.. 21 

<E> Last Granule .=•,..,.,..... 21 

<F> First Granule .....'..;»..'...., , 21 

<R> Read Sector ,,V... . . .... .' .: 22 

Left/Right Arrow; Lp/Dowh Ar row. . . '' 22 

<M> Modify Sector ,.,., ., , ,';. : 23 

The Screen Display/. ..'.." .'..".. '"'"' 23 

Movement In The Display 24 

Zapping The Sector ,.... 25 

Writing The Sector To Disk.. 26 

Printing Functions 27 

<P> Print Sector 27 

<B> Set Baud Rate 29 



lauie or (Jonients (cont.) :: . ' •' 

SEC^ICN,,, ;, , J( ^ndj.^oc .. 'a,:. s >- ..> I PAGE 

' ' •■ " :;I >A • V ! ' ,u , >l <ljh ■•■ ( i(/itj 'j ■■: rile! 'i ,:io;.'-;; 

£ ,,;.: <D> n .Disk, 2Ja,p ^j. . , s j!,;.;,i. .!,4> «*-• +/*u'. .•..-'. ,:J.i, j 30 

•.-.TV -jf:' ..; .":■ ••'"■i"? 0\.-' ,- 5 ;!'M!i. >,<•.->.. ' .;noi' 

"'/'i-, t)I$k'Ac,cess;» . >( , .«.•; .<*-y ..>£..;>..';;:!.; J;*.. . : < 32 

^ i ,n <!/* En.|er= Ti^ick^i.i. . v. .I..;.-....;.*. ./ 32 

",,;',">' £T> ,F<nte;i, Dfi^e . J.*!... ...:u.. iij.i» i .if 33 

, ' '. ijf <F> ; ^r^st ^racjfe ••■.."..'•.. .-i'. . i-q r - ■ 34 

Arrow Commands * , . . . I' 34 

<L> Locate 35 

, V. Dijsk Repair Command si. ^ ■ 36 

." '' Print , Commands . ... .,.)jv <' 36 

.i-i" -^ 

Killing Files j ...>... 37 

<K> Kill 37 

Part II: Zapping Techniques 38 

Introduct ion 38 

Disk Structure 39 

The Operating System 46 

Disk Repair 48 

Introduct ion 48 

Errors - Types, Causes And Repairabil i ty 48 

Error Prompts , 49 

Error Messages During A Read 5 

Error Messages During AWrite 51 

The Fixes., , 51 

Automatic Repairs....,,,..., 52 

Minor Repairs And Modif icat ions 53 

Real locating A Granule 5 3 

Backup The Onbackupabl e 55 

Fixing A Tokenized BASIC File 55 

Rebuilding Files, Tracks, Etc 60 

Retrieving Killed Files 63 

APPENDICES . 

Standard ASCII Character Set 65 

Dccimal-Hexidecimal Conversion Chart 68 

BASIC Keyword Token Codes 70 

Using Other VIP Library Programs 71 



li 



VIP Disk-ZAP 

Disk repair is something that each of us heeds. 
Sooner or later we drop a disk, or our operating system 
fails, leading to- disk failure. Up on the screen pops a 
dreaded message such as "I/O ERROR". The fie is lost. 
It could be a grocery list, or the. only copy of a 
valuable customer order database. Now, with the 
VIP Disk-ZAP, anybody, from non-programmer to 
experienced assembly language programmer, can fix 
repairable disk errors in minutes and return to work 
with the fixed disk. 

The VIP Disk-ZAP is a fast machine-code program for 
use with the standard' Color Computer disk operating 
system. It was designed with the non-programmer in 
mind. The user is guided through every step with 
easy-to-use menus and full message prompting. An 
attractive and well organized screen display makes the 
program even simpler to use. It features a split 
screen, dual cursor format which allows total control 
and monitoring of every step. Commands are all single 
key mnemonics which are easy to use and remember. Every 
modification to be made to the disk or file is verified 
with you before being finally made so you don't have to 
worry about making careless mistakes. 

The many features of the VDP Disk-ZAP make it the 
only disk repair utility you'll ever need for your Color 
Computer. Vou can: 

* Fix - simply - all repairable disk errors. 

* Verify to find all errors throughout the entire 

disk and obtain a description of any error 
found . 

* Move easily through the fie or disk by sector 

or track. 

* Repair individual files or the entire disk at 

once. 

* Address any disk drive; work on any granule, 

track or sector. 

* Modify textfie or disk using ASCI or 

hexidecimal input. 

* Copy sectors to any drive and track. 

* Locate specific numeric or ASCII strings for 

modific a tion . 

* Print sectors to any RS-232 device at any of six 

different baud rates. 

Hi 



PART I: How the VIP Disk-ZAP Works 



About This Manual 

Disk repair requires two things: a good repair 
utility and knowledge. The first we have provided with 
the VP Disk-ZAP program. The second you will obtain 
from experience, from reading reference works, and from 
this manual. There is no general work on the market 
which deals with data recovery; nor is there any book or 
article dealing with data recovery with the Golor 
Computer. This manual cannot pretend to teach you any 
but the most simple concepts. Lhtil there is some work 
devoted to the subject you will have to depend on your 
disk manual, technical reference manuals, and on the 
rudiments taught in this manual. Still, most disk 
errors are easily fixed, so don't despair. 

This Manual is divided into two sections. The 
first part tells you how the VIP Disk-ZAP works, 
detailing its menus, commands and screen displays. 
After the loading instructions are explained, the 
commands of the Master Menu are discussed in a logical 
order. Some of these commands present a separate menu 
with sub-commands which are also fully discussed. Since 
an understanding of the basics of disk structure is 
required before learning how to use this program, it is 
highly recommended that you read the section on disk 
structure in Part II before learning how to use this 
program. 

The second part of this Manual gives a general 
beginner's explanation of how to use the VIP Disk-ZAP to 
fix your disks. It includes a discussion of the 
structure of the disk, the basic concepts of disk 
repair, a summary of common errors which can affect disk 
access and their causes, fixes for those errors, and 
instructions on how to rebuild files and the directory, 
manually backup a disk, and allocate a granule 
containing an unrepairable sector. 



This manual assumes that you are familiar with the 
hexidecimal number systeW. For your convenience a 
cross-reference chart between decimal and hexidecimal, 
numbers is provided in the Appendix. On thing you 
should be aware of is that in many computer usages, 
items are counted beginning with the number zero. Thus, 
there are 35 tracks on each disk, numbering from to 
3 4. When referring to items numbered beginning with 
zero, the convention is to call the number assigned 
"relative". Thus, the 35th track is relative track 34; 
the first track is relative track 0. This can be awful 
confusing at times, so be careful. 



Loading the VIP Disk-ZAP from the Diskette 

UNPLUG YOUR JOYSTICKS! 

Mount the VIP Disk-ZAP master diskette in Drive 0, 
type LOADK'ZAP" and press <ENTER>. The program will 
automatically load and execute. A billboard will be 
displayed while the program is loading and prior to 
execution. When the program has executed, the Master 
Menu will appear. 

System Requirements 

The VIP Disk-ZAP program is only designed to be 
used with the standard Color Computer Tandy operating 
system. It will not work on other operating systems for 
the Color Computer such as FLEX or OS-9, or on files 
created using such operating systems. 

Getting Started 

Now that you have read the section in Part H 
explaining disk structure, put a disk which you don't 
care about ruining (or write protect a disk) and place 



it, in .drive zero and let's get started,, After, the 
program has executed, the Master Menu will appear: ..-,■• 
displaying a selection of single key entry commands. 
The following is a list of the commands available as 
they appear on the Master Menu with a brief description 
of their functions: 
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Directory <A>: Pressing this key will elicit the 
directory for the drive specified. 

Disk Zap <D>: This command allows repairs to be 
made to the disk as a whole, A separate menu 
controls Disk Zap access. 

Exit Program <BREAK>: Press this key to exit the 
program and return to BASIC. 

File Name <N>: With this command you are told the 
name of the last fie accessed. 

Fie Zap <F>: This command allows access to 
particular files for repair. A separate menu 
appears to prompt the user in File Zap access. 

Kill <K>: This command allows you to kill any 
fie on the disk. 

Read Sectors <R>: With this command you can load 
several sectors into memory for copying. 

Toggle X-Late <X>: This command toggles between 
the true ASCII and original Color- Computer 
display. 

Toggle Base <S-flFT><@>: With this command you 
toggle between the hexidecimal and decimal 
number systems for selecting drive, track and 
sector numbers. 



Toggle ASQI <CLEAR>: This key toggles input in | 
the Modify and Locate functions between ASCH 
and hexidecimal. 

Verify Disk <V>: This command causes the program 
to verify the entire disk, stopping 
sequentially at any Errors found. 

Write Sectors <W>: This command is used to Write 
the sectors read into the memory with the Read 
Sectors command to another location. 

At the bottom of the screen on a Command line is 
the prompt "REQUEST?" which asks for input of one of the 
letter commands. All commands must be entered in the 
uppercase mode (discussed below). 



Toggle Commands: X-Late, Base, and ASCII 

toggle Base. At the right of the screen is the 
flag "UXDEC. "DEC is the "Toggle Base" flag which, 
when "DEC", stands for "decimal" and indicates that 
numeric input into the system when indicating the drive, 
track or sector to be accessed must be in the decimal 
number system (base 10). Decimal may not be used to 
input in the modify functions. Input is restricted to 
hexidecimal numbers. (See Modify, discussed in the Fie 
Zap section.) You may change your input to hexidecimal 
by pressing <SnFT><@> to Toggle the Base. When 
hexidecimal has been toggled the "DEC flag will change 
to "HEX". Pressing it again toggles back to decimal. 
The number base may CNLY be toggled from the Master 
Menu. 

When in either base, you have the option of forcing 
input to be in the alternative base by preceding the 
number by a character code. If you are in the DEC base, 
you may input hexidecimal numbers by preceding each 
number with a "#" symbol. When in the HEX base you may 
input decimal numbers by preceding each number with the 



"&" symbol. The following example shows use of these 
symbols with the Enter Track command from the Disk Zap 
menu (see below): 

EXAMPLE: TRACK, SECTOR? &17, 03 

The above example assumes that you are in the HEX base 
and want to input the drive and track numbers in decimal 
for the directory track (see Part fl). Track number 17 
is preceded by the "&" symbol to allow decimal input. 
There is no need to precede the sector number 03 with 
the ampersand since the hexidecimal and decimal numbers 
for 03 are the same. 

When in the decimal base, the numbers displayed in 
the DRV, TRK and SEC indicators, the GRAN indicator when 
accessing sectors (discussed below) and the relative 
BYTE indicator in the Modify functions discussed below), 
will be in the decimal base. Otherwise they will be in 
the hexidecimal base. 

Toggle X-Late. The "X' of the "UXDEC" flag is the 
"Toggle X-Late" ("translate") flag which is either 
present or not present. Its presence is toggled by 
pressing <X> from the Master Menu ONLY. When present, 
as it is when the program is first executed, it 
indicates that the ASCI display of files will be 
translated into the Standard ASCII Character Set (see 
Appendix and the discussion of the screen display 
below); when it has been toggled to "U DEC without the 
"X', this indicates that the ASCI display will show the 
file in the character set used by the Color Computer 
display generator chip. 

Toggle ASCfl. Sometimes, you will be required or 
you will desire to input ASCII characters (i.e., words 
and characters) instead of numbers. ONLY the Modify 
(see Disk and File Zap commands) and Locate (see Disk 
Zap commands) allow ASCI input. In the Modify function 
you must choose specifically between making 
modifications in ASCII or in hexidecimal (never 



decimal]). The system begins with ASCII input being 
enabled. Hexidecimal input is enabled by using the 
Toggle ASQI command, <GLEAR>, which may be done at any 
time. When ASQI is enabled, as it is when the program 
is first entered, it is indicated on the screen by the 
presence of the flag "ASC at the far right of the 
screen next to the "LMDEC flag. Even when the ASGH 
option has been disabled, the system will accept all 
command letters. 



Toggling Upper/Lower Case. When the program is 
first executed all keyboard entry is in upper case. To 
input both lower and upper case press <SHIFT><0>. This 
toggles case status just as in BASIC. Case status may 
be toggled at any time when using the program. A case 
mode indicator is placed in the first position of the 
"UXDEC flag. The "U' indicates that the uppercase mode 
is in use. When the case status is toggled to 
lower/upper case the "U 1 changes to an "L". NOTE that 
all commands must be input in upper case. 



<BREAK>: Exit 

The <BREAK> key is the general exit command and has 
two distinct uses: exiting from a command to the Master 
Menu and exiting from the Master Menu out of the program 
altogether returning to BASIC. While using the commands 
and sub-commands of the VIP Disk-ZAP, you may exit to 
the Master Menu at any time by pressing <BREAK>. 

However, pressing <BREAK> while in the Master Menu 
will initiate an exit from the VIP Disk-ZAP. It is very 
convenient to exit from a utility program to either test 
your handiwork or get back to work with what you have 
fixed. You may only exit this program from the Master 
Menu. When you press <BREAK> to initiate the exit the 
system will prompt on the command line "Do you really 
wish to exit?" Press <Y> to exit to BASIC; if you press 
any other key the exit will be aborted and the 



"Request:" prompt will reappear awaiting your further 
command. 



The remaining commands on the Master Menu will be 
discussed in logical divisions. The first section, 
entitled "File Determination," will be devoted to 
calling up the disk directory and determining which 
files are accessible. This section includes the 
Directory and File Name commands. The second section, 
entitled "File and Disk Access," consists of the 
commands used for actual fie and disk access, error 
checking and modification. This section includes the 
Verify, Read and Write Sectors, and the File Zap and 
Disk Zap commands. The File Zap and Disk Zap commands 
each call up a separate menu for manipulation of the 
individual files and the disk as a whole. A final 
section will discuss the KILL command. 



File Determination 

The following sections deal with determining which 
files to access. It includes the Filename and Directory 
commands. 



<F> Filename 

The Filename command may be used from the Master 
Menu to determine the last filename used. When you 
press <N> the screen will clear and at the bottom will 
appear the drive, track and sector numbers of the last 
file accessed. Below that will appear the prompt 
"Filename:" followed by the name of the last diskfie 
accessed, including its extension and drive number. 
Press <BREAK> to exit to the Master Menu for further 
work on that or another file. 



, ; <A> Directory 

This command directs the system to display the 
directory of the disk to be repaired. After you press 
<A> the Master Menu disappears and you are prompted wit 
"Drive:", a request for the drive number of the drive 
containing the disk whose directory is to be displayed. 
Upon entering the number (0, 1, 2, or 3), or <ENTER> for 
the last drive accessed, the system will automatically 
display a directory of the disk requested. The 
directory for the specified drive will be displayed in a 
two-column format with the drive number and number of 
free granules on the disk shown on the top line of the 
display. Each entry in the directory will be followed 
by a number indicating the number of granules allocated 
to the file on the disk, and the letter "A" for ASCII or 
"B" for binary to indicate the nature of the fie. 



Occasionally an asterisk or an "R" may also appear 
in the directory after the filename. These characters 
indicate that there is an error in the granule 
allocation of the file which will prohibit access of 
that file. The errors are of two types. In one 
instance the granule allocation table contains a number 
other than the allowed (in hex) 00-43, FF, or C0-C9. 
This error elicits an asterisk by the bad file name. 
The second error is caused by a granule allocation byte 
referring to itself as the next granule in the file, 
causing the system to repeatedly load that granule, 
believing that the fie has over 68 granules. Because 
of this repeated access of the same granule, this error 
is assigned an "R" in the directory. Whenever you 
encounter either of these errors when Verifying the disk 
a BAD FILE error prompt will be displayed. The system 
will not allow you to load any such damaged sector for 
repair until the directory is repaired. (To effect 
repair see the discussion of the structure of the 
directory and the discussion of errors in Part II.) 



From this directory you may obtain the names of the 
files you wish to access for repair in the File Zap 
function (see the next section). If the directory 
consists of more than one page the system will prompt 
"There's more - press any key" and await entry of any 
key except <BREAK> to display the remaining pages. To 
exit to the Master Menu from any but the last directory 
page press <BREAK>. When you reach the last directory 
page the system will prompt with "Last page, hit any 
key." Press any key to exit to the Master Menu. 



File and Disk Access 

Hie following sections cover accessing a diskfie 
or the disk as a whole to make repairs. The first 
command, Verify, lets you determine which sectors are 
faulty, and what the errors are. The Read and Write 
Sectors commands together allow you to copy your disk by 
reading many sectors into memory and writing them to 
whatever disk or portion of the disk you desire. File 
Zap lets you access particular files for repair; Disk 
Zap lets you access the disk as a whole for repair. 



<V> Verify Disk 

When you encounter a disk error when using one of 
your disks which prohibits disk access, you will want to 
locate the error and find out its nature. The Verify 
Disk command performs this function. Upon pressing <V> 
from the Master Menu the VIP Disk-ZAP searches through 
the entire disk, through each sector of each track, 
looking for errors. When it finds an error it attempts 
several times to read the faulty sector, and then stops 
so that you may note the location (drive, track and 
sector) of the error. It also gives a description of 
the error on the COMMAND LINE at the bottom of the 
screen (see Part D) and prompts "SKIP SECTOR OR EXIT?" 
Do not be alarmed when, as the system tries to read the 
same sector, it changes the contents of the sector. 
This indicates that it has encountered a faulty sector 
and cannot read it correctly. 

After you have noted the location and nature of the 
error, press <S> to skip the faulty sector and continue 
to verify until it encounters the next error, if any. 
(ff you press <BREAK> you will exit the Verify Disk 
function and return to the Master Menu.) Continue with 
this process until the entire disk has been verified. 
The VJP Disk-ZAP allows you to read sectors on tracks 
beyond the standard 35th track of the Color Computer 
operating system for systems which have an extended 
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35-plus track format. When the system reaches the erd 
of the 3 5th track it will prompt: "Continue or exit?" 
If you have a 35-plus track format, press <C> to 
continue; if you have the standard 35 track format, 
press <E> to exit. Once you have located the errors and 
found out their sources, you may then proceed to repair 
the disk through either the File Zap or Disk Zap menu 
commands. 



<R>, <W> Read Sectors/Write Sectors 

These two commands are a matched pair used to copy 
or manually backup portions of your disk to another 
location, either another disk or another portion of the 
same disk. This copy function is useful if you wish to 
copy your entire disk to another diskette, if you vish 
to save a copy of your directory track before you 
operate on the original, or for any other of your copy 
needs. 

To begin, you must Read the sectors to be copied 
into computer memory. A 32K computer will hold 92 
sectors (5 tracks, 2 sectors); a 16K will hold 
considerably less, and a 64K will hold considerably 
more. To Read the sectors to be copied press <R> from 
the Master Menu. The system will prompt at the bottoin 
of the screen "Drive, Track, Sector?" and await your 
entry of the starting point of the sectors to be read. 
Recall that the drive, track and sector numbers may be 
input either in the hexidecimal or decimal number 
system. The base used is toggled with the Toggle Base 
command by pressing <SHFT><©>; you may also force input 
of either base wliile in the other base (see discussion 
of Toggle Base above). 

After you have entered the drive, track and sector 
numbers and pressed <ENrF.R>, the system wiD prompt 
"Sector Count?" The system wiD then await the number 
of sectors you desire to be read into memory. Below 
this prompt will be a reminder, in the base you have 
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toggled, of the maximum number of sectors which will 
fit in your computer buffer, reading "Count Limit:(#)." 
When you have input the number of sectors to be read 
into memory, beginning with the specified sector, and 
pressed <ENTER>, the system will read the designated 
sectors. 

NOTE: The VIP Disk-ZAP allows you to read sectors on 
tracks above the standard 35th track of the Color 
Computer operating system for systems with extended 
35-plus track formats. 

Once these sectors are in memory the system wiH 
prompt "Request?" You then may Write the sectors to a 
new location. The procedure is the same as for the Read 
command, including the prompts, except that it is 
initiated by pressing <W>, and after entry of the number 
of sectors to be written, the system will prompt with 
"Do you really wish to write?" A <Y> response wiD 
cause the sectors to be written to the designated 
location; any other response will abort the Write. All 
writes arc verified after being written to assure 
accurate transfer of data. 

NOTE: that the Read Sectors command in the Master Menu 
is not the same as the Read Sector command in the File 
Zap menu. The latter command only allows one sector, 
the current one, to be read into memory. See the 
relevant section under File Zap. 



<F> Fie Zap 

When you press <F> for File Zep from the Master 
Menu the system clears the Master Menu and sets out the 
following prompts: 

DRV: 00 TRK> 00 SEC: 00 UXDEC ASC 

File Name: <Flashing Cursor > 
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File Name: (Last filename used)/Oast extension, 
initially VTP):Gast drive number) 

The system awaits your entry of the name of the fie 
which you wish to inspect or repair. You must enter the 
filename, the extension used and the drive in which the 
disk containing the fie is located. The extension is 
necessary when you are changing extensions; thus, if you 
are accessing an ASCII file with the extension "BAS" 
right after loading the program you must include the 
extension BAS or the system will apply the default 
extension "VIP". The correct name and extension may be 
obtained by using the directory command (see section 
<A> Directory above). The filename must be separated 
from the extension by a slash ("/") or a period ("."); 
the drive number must follow the extension and must be 
preceded by a colon. 

EXAMPLE: File Name: TESTFILE/VIP:0 

The above example responds to the prompt with the 
filename "TESTFILE", with the extension "VIP", located 
in Drive 0. 

The VIP Disk-ZAP stores the name of the last 
diskfile accessed in a buffer to eliminate the need to 
repeatedly type in the same filename. Below the 
filename request line is a listing of the last accessed 
filename. If you desire to access the same file you may 
press <ENTER> instead of retyping the filename. 

Upon entry of the filename, or pressing of <ENTER>, 
the system will attempt to access that fie. If the 
fie is not found, a prompt "FILE NOT FOUND" will appear 
on the command line. Perhaps you forgot the extension? 
Try again. 2 the file is found, it wiD be accessed, 
on the command line will appear the prompt "FILE FOUND", 
and the screen will change to display the File Zap menu 
giving the commands which may be used to access, modify 
and transmit the fie. The menu lists: 
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Fie Name <N>: Gives the name of the last He 
accessed. 

Directory <A>: Supplies a directory of the disk 
in the drive specified. 

Last Granule <E>: Accesses and displays the first 
sector of the last granule of the named file. 

First Granule <F>: Accesses and displays the 

first sector of the first granule of the named 
fie. 

Read Sector <R>: Commands the system to read the 
current sector. 

Modify Sector <M>: Enters the modify mode to 
modify the sector displayed on the screen. 

Print Sector <P>: Allows the current sector to be 
sent to a printer or any other RS-232 device. 

Set Baud Rate <B>: Elicits a menu for selection 
of the proper baud rate for transmission of 
data. 

Mmus 1 Sector <LEFT ARRCW>: Moves back one 
sector in the diskfie. 

Add 1 Sector <RIGHT ARRCW>: Moves ahead one 
sector in the diskfile. 

Minus 1 Gran <LP ARRCW>: Moves back a single 
granule in the diskfile. 

Add 1 Gran <DCWN ARRCW>: Moves ahead a single 
granule in the diskfile. 

Exit File Zap <BREAK>: Exits from Fie Zap to the 
Master Menu. 
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Below the menu is a listing of drive, track and 
sector numbers, listing the numbers of the last fie 
accessed (in the base selected), the hex or decimal and 
ASGH flags and the prompt "Fie Request?" asking for a 
command from the Fie Zap menu. 

The commands in the menu will be discussed in a 
logical order below. The first set of related commands 
are those used to access the fie. These 
include: 1) the File Name and Directory commands which 
allow you to call up a particular diskfie and to keep 
track of which fie you are working on; 2) the First and 
Last Granule commands used for easy movement to the 
beginning or end of the fie called up; 3) the Read 
command used to peruse your fie sequentially; and 
4) the arrow commands which allow sequential access back 
and forward of sectors and tracks when accessing a fie. 

The second set of commands allow manipulation of 
the diskfie to be repaired. These commands are all 
used in the Modify function, and include the ASCH/H2X 
input option, the arrow keys used to move the cursor 
about the sector being modified, and the commands used 
to save the zapped sector to the disk. The third set of 
commands relate to Printing or transmitting a sector. 
This set includes the Print and Set Baud Rate commands. 
The final function is controlled by the <BREAK> command 
which allows exit from the Fie Zap function. 



Fie Access Commands 

The Name and Directory commands allow you to call 
up the fie which requires repair. The Read command 
allows you to peruse the fie. The First and Last 
Granule commands provide an easy means to get to a 
convenient place to begin inspecting a fie. Once the 
fie has been displayed, you may use the arrow keys to 
move back and ahead in the fie. 
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The Screen Display 

Before going on to a discussion of how to access a 
file, an explanation of the screen display of an 
accessed file is in order. When the VEP Disk-ZAP 
accesses a file it calls in one sector of the file at a — 

time for display. The screen is split to display the 
sector being accessed, The top half of the screen 
contains an ASQI representation of the entire sector. 
The bottom half contains the usual indicators and flags. 
Provided the sector contains an ASCI file and you have 
retained the ASCII option with the TOGGLE X-LATE option 
from the Master Menu, the sector will appear just as it 
did when you created it - in its ASCII format with upper 
and lowercase letters, etc. 

Many of you are experienced programmers and may not 
be used to seeing a pure ASCII display; instead, you are 
used to seeing the display presented by your monitor 
program. To accomodate such users we have included an 
option to allow them to select to see the accustomed 
non-ASCII display. To select that option press <X> to _ 

Toggle X-Late (see the discussion under Getting 
Started). When <X> is pressed from the Master Menu, the 
"UXDEC" flag wiE change to "U DEC and the heretofore 
readable sector displayed will change to skads of 
gobbledygook - punctuation marks, parentheses, numbers 
and uppercase characters. These are all representations 
of the same sector, but using a different system than 
the standard ASCII display used in the ASCII option. 

Although many of you will never choose other than 
the ASCH option, you should be aware that if you 
accidentally press <X> while in the Master Menu, you 
will get a very different screen display of the sector 
accessed. The following discussion of the ASCH system 
is included to help you understand the reason for this 
different display and to help you understand how to read 
and change the ASd or non-ASO display when it 
becomes necessary to repair or modify your disk. 
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The ASCII System 

v 

ASCII is a standard for symbols used in 
communications. "ASCff 1 is an acronym for "American 
Standard Code for Information Interchange". The ASGH 
standard potentially contains 256 symbols which are 
represented by numeric values from to 255 decimal (0 
to FF hexidecimal). The first 128 ASCH symbols 
constitute the Standard ASCH Character Set and are 
absolute standards for communication symbols, such as 
the letters of the alphabet, punctuation and control 
codes. The final 128 symbols (from 128 to 255) 
constitute the Extended ASCII Character Set, which will 
be discussed later. 

Before going on with this discussion you should 
become familiar with the Standard ASCII Character Set 
chart in the Appendix. The standard ASCII character set 
is comprised of the 128 ASCII symbols from decimal 
through 127. The first column gives the first 128 ASCII 
symbols in order; the second column gives the display of 
those symbols using the non-ASCII option; the third 
column gives the display of those symbols using the 
ASCII option; the fourth column gives the decimal 
numeric equivalent of the ASGI symbol; column five 
gives the hexidecimal equivalent; and the final column 
explains how to generate the ASCH symbol and its screen 
display equivalent through your Color Computer keyboard 
while modifying a sector using the ASCH input option. 
Thus, from the Appendix you can see that to generate the 
ASQH symbol capital "A", and its screen display capital 
"A" (in either the ASCH or non-ASCII option) you either 
place the hex number 41 in the appropriate location in 
the hex display in the hex option or, in the ASCH 
option, input a capital "A" from the keyboard in the 
proper location in the ASCII display. 

The first 32 ASCH symbols, with numeric values 
from to 31 decimal, are control characters. They were 
specifically devised to be used to control functions of 
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devices which accept ASCH data. The next 96 ASCI 
symbols, from 32 to 127 decimal, are the alphabet, in 
upper and lower case form, the numbers, and the 
conventional symbols seen on the typewriter keyboard 
such as the colon, the ampersand, the dollar sign, etc. 
In every system adhering to ASQI the ASCII symbols 
represented by the numbers from 32 to 127 decimal will 
be the same. 

The Extended ASOU symbols from decimal 128 to 25 5 
are different. There is no standard symbolic equivalent 
for them. Each system (computer, printer, etc.) may use 
these decimal numeric equivalents to produce different 
symbols. Because of this lack of standard ASCH 
symbols, monitor display for the numeric equivalents 
from decimal 128 through 255 are not uniform; every 
system assigns different symbols to the numbers from 128 
to 255. Therefore the Appendix does not show anything 
for those decimal equivalents. The Color Computer 
represents these numeric equivalents as graphics blocks 
of various colors (see your BASIC manuals). Cards are 
available commercially listing the numeric equivalents 
and the corresponding pixel displayed. 

The VIP Disk-ZAP is totally compatible with ASCH. 
This means that all functions of this program requiring 
modification of a disk allow modification in the ASCH 
mode, and the memory contents holding the diskfile or 
sector are in the ASCII format. The screen display in 
the ASCH option is also ASCH compatible. The 
non-ASCII option display, however, IS NOTt If you call 
up a file using the n on- ASCII option, you will 
immediately see that the screen display is not ASCH 
compatible. What you put in your file as normal looking 
words with real letters have become real gobbledygook, 
the letters being replaced by numbers, punctuation marks 
and whatever odd doohickey. This aberration is due to 
the construction of your Color Computer, since the VIP 
Disk-Zap non-ASGH option merely uses the display that 
the Color Computer generates. As you can see, the 
character generation component of the Color Computer 
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which displays the characters on the screen is not ASCII 
compatible. 

Let me explain this further. As was said, ASCff is 
just a set of numbers assigned to some communication 
symbols so that manufacturers of terminals, printers, 
etc., could create uniform products. There is no 
particular reason the number 97 decimal (61 hex) has to 
be assigned to the letter "a"; it was just the numeric 
equivalent chosen for the ASCII system. Every system 
adhering to ASCII wiE have the number 97 decimal equal 
the letter "a". 

Why all this concern about numbers? Because your 
computer stores information in numeric form instead of 
as characters. When you press a key on the keyboard, 
what you are really doing is putting a number into 
memory, that number being the numeric equivalent of the 
ASd symbol you have generated. It just so happens 
that' the letters of the alphabet and other standard 
symbols on your keyboard ARE the ASCII symbols 
themselves, and thus, when you press a key the 
corresponding numeric equivalent for that ASCII symbol 
is put in memory. In a totally ASQH compatible system, 
when you press the "a" key, you have generated the ASCII 
symbol "a". How is "a" represented in your memory? By 
looking in the Appendix you can see that the numeric 
equivalent for the ASCII symbol for "a" is decimal 97 
(61 hex). (Actually the memory contains the binary 
equivalent of the decimal number 97. For convenience we 
win refer to decimal numbers when referring to memory 
contents.) When you press "a", your memory receives a 
decimal 97 in the appropriate memory location. 

The monitor (your TV) which displays your memory is 
controlled by a device which generates characters from 
the ASCI numeric equivalents in the memory. If the 
character generator is ASCI compatible, the decimal 97 
from the memory, generated when you pressed the "a" key, 
will go to the character generator, which in turn will 
tell the monitor to show an "a" on the screen. But what 
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if the character generator is not ASCII compatible? 
This means that it may assign a different symbol to the 
ASCB numeric equivalent. 

This is exactly what causes the wierd screen 
display of your ASCII files in the VIP Disk-ZAP when 
using the non-ASQI display option. The Color 
Computer's character generator assigns different symbols 
to many of the ASCII numeric equivalents. Most notably, 
the ASQI symbols for the lower case alphabet have been 
exchanged, in the character generator, with the control 
symbols CTRL A to CTRL Z with their screen display. The 
Appendix shows this. As was shown, in an ASCII 
compatible system, a decimal 97 will generate the letter 
"a". In the Color Computer screen display, however, 
decimal 97 generates an inverse exclamation point. By 
glancing at the screen display of the Color Computer for 
the ASCII lower case alphabet (from decimal 97 thru 122) 
you can understand why your wonderful file has been 
turned into garbage in the non-ASCII display option. 

This display difference should have absolutely no 
effect on you. You can choose to use either the pure 
ASCI display or the Color Computer non-ASCH display, 
whichever you are most used to or like the best. The 
information on numeric equivalents of ASCII symbols will 
prove very useful once you begin making modifications to 
your files. This concept is crucial to proper Zapping. 

Now that you understand the display choices and the 
ASCII system, we can return to the discussion of the 
File Access commands in the File Zap menu. 



<N> Name 

This command was described above in explaining the 
prompting resulting from pressing <F> to enter the File 
Zap mode. See that discussion. The same command is 
also available from the Master Menu. Note that the Disk 
Zap mode lacks this command since that mode deals with 
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the disk as a whole instead of with individual files on 
the disk. 



<A> Directory 

This command is also identical in function and 
execution to that described for the same command in the 
Master Menu. The Directory command is also not 
available in the Disk Zap mode, as that mode does not 
call up individual files listed in the disk directory. 



<E> Last Granule 

This command is used to access the first sector of 
the last (or only) granule of the designated disk f£e. 
When it is selected, that sector will be displayed on 
the screen, and you will be prompted with 
"FILE REQUEST:". You may move through the Be for 
inspection using the arrow keys (see discussion below). 
You may press <ENTER> to return to the File Zap menu, 
<BREAK> to return to the Master Menu, or any File Zap 
command key to execute a command. 

Whenever a sector is actually accessed from the 
File Access or Disk Access commands, along with the 
other indicators for drive, track, sector, ASCII, number 
base and upper or lower case wiE appear a GRAN 
indicator. This indicator tells you the granule number 
of the sector accessed in the number base you have 
selected from the Master Menu. This number will prove 
useful when it becomes necessary to repair a disk (see 
the section on Disk Structure in Part ID. 



<F> First Granule 

This command is used to access the first sector of 
the first (or only) granule of the designated disk file. 
When it is selected, that sector will be displayed on 
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the screen, and you wffl be prompted with "File 
Request:". You may move through the fie for inspection 
using the arrow keys (see discussion below). You may 
press <ENTER> to return to the File Zap menu, <BREAK> to _ 
return to the Master Menu, or any File Zap command key 
to execute a command. 



<R> Read Sector 

This command is used to load the current sector of 
a designated disk fie, i.e., the last one accessed, 
into memory and display it on the screen for inspection. 
When it is selected, that sector will be displayed on 
the screen, and you will be prompted with 
"FILE REQUEST:". You may move through the fie for 
inspection using the arrow keys (see discussion below). 
You may press <ENTER> to return to the File Zap menu, 
<BREAK> to return to the Master Menu, or any File Zap 
command key to execute a command. 



Left/Right Arrow; Up/Down Arrow 

In normal fie access functions, used to locate the 
sector to be zapped, the arrow keys move you through 
sectors and granules of data. The left and right arrow 
keys move you back or ahead one sector in the 
file - thus the menu descriptions "Minus 1 Sector" and 
"Add 1 Sector". The up and down arrows move you back or 
ahead one granule in the file - thus the menu 
descriptions "Minus 1 Gran" and "Add 1 Gran". In using 
any of these arrow commands, if you reach the boundaries 
of the fie a prompt will appear at the bottom of the 
screen telling you that .you have reached "First sector 
of fie", "First Granule of fie", "Last sector of ffle" 
or "Last granule of fie". 

NOTE that the arrow keys perform different functions 
when in the Modify function. 
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<M> Modify Sector 

The modify function is the heart of VIP Disk-ZAP. 
It is primarily with this function that you will repair 
the disk - or ZAP it (see Part II). 

Modification is done one sector at a time. The 
first task before modification is to determine what 
modification is necessary to make a repair by using the 
Verify command or by inspecting the diskfiles or the 
disk as a whole. Once you have determined what sectors 
need modification, you then must locate the sector using 
the Read, First and Last Granule commands and the arrow 
key commands. The Modify command will access the first 
sector of your diskfUe or the last sector accessed for 
Zapping. 

When you locate the sector to be modified, on the 
Command Line at the bottom of the screen will be the 
prompt "Fie Request". Press <M> to begin modification. 
The screen will go blank, and then a new screen display 
will appear (the screen display in the modify function 
is described below). The cursor rests at the first byte 
of the sector (relative byte zero), awaiting your 
action. 

To return back to the File Zap menu press <BREAK> 
and then <E> for Exit. Press <BREAK> twice to return to 
the Master Menu. 



The Screen Display 

When the modify function is called, the screen 
display is split into two parts. On the top half of the 
screen is the ASQI display of the sector of the disk to 
be repaired. The display contains one sector from the 
disk, displayed in eight lines of text, each containing 
32 bytes of data, for the total 256 bytes per sector. 
The bottom half of the screen contains a hex display, 
the Gran, Drive, Track and Sector indicators, the UXDEC 
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and ASCH flags and a command line for prompts from the 
system and input from the user. The hex display is 
comprised of a relative byte counter and four lines of 
eight bytes each of numbers which correspond to the 
ASQI display characters. The 32 bytes of the hex 
display arc equivalent to the single sector ASCH 
display (i.e., 1/8 sector); thus the eight lines of the 
ASCH display will be represented by eight consecutive 
hex displays. 

A double cursor indicates the current position in 
both the displays. The hex number indicated by the 
cursor in the hex display is the numeric equivalent for 
the ASCH symbol at the position of the cursor in the 
ASCH display (see the discussion of the ASCH system 
above). The relative byte counter indicates the byte 
number, in the base chosen from the Master Menu with the 
Toggle Base command, at the position of the cursor. 
This helps you keep track of where you are in the split 
display, especially in the eight consecutive 32 byte hex 
displays per sector. 

The hex display provides the numeric equivalent, in 
hexidecimal, of the ASCH symbol at the position of the 
corresponding cursor in the ASCH display, Numeric 
equivalents of ASCH symbols are given in the Appendix. 
Thus, the symbol "A" in the ASCH display will 
correspond to the number 41 hexidecimal in the hex 
display. (Note that the screen display may differ from 
the ASCH symbol that the numeric equivalent represents 
when the non-ASCII option is chosen - see the discussion 
of the screen display above.) 



Movement in the Display - 

Movement through the ASCH and hex displays is done 
via the arrow keys. The arrow commands have a different 
effect in the modify function than in other file access 
functions (see discussion above). When in the modify 
function the arrow keys are used instead to move you 
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about within the sector. The left and right arrows now 
move the cursor one byte back or forward in the sector. 
The shift key plus the up or down arrow now moves the 
cursor left or right eight bytes in the ASd display 
and simultaneously up or down one line (eight bytes) in 
the hex display. The up and down arrow keys alone move 
the cursor up or down one line in the ASCE display (32 
bytes) and simultaneously up or down four lines (one 32 
byte display block) in the hex display. 



Zapping the Sector 

Changes to the sector may be made through 
alteration of the altered sector displayed and writing 
of the sector back onto the disk. Alteration may be 
done either by inputting numbers into the hex display at 
the position of the cursor or by inputting ASd symbols 
into the ASQI display. The input options are toggled 
by pressing <CLEAR>. When the ASQI option is selected, 
both the number flag and the ASC flag will be displayed 
on the screen; when the hex option is chosen, only the 
number flag will be displayed. 

When in the he| input option, you may ONLY input in 
the hexidecimal number system. (Jhlike when entering the 
drive, track and sector numbers (see the discussion of 
Toggle Base above), input into the hex display may not 
be done in decimal, but only in hex. Therefore, even if 
you have elected to be in the decimal base by pressing 
<SHFT><@> to toggle the number input from hex to 
decimal from the Master Menu, the system will interpret 
all numbers input as hexidecimal. The proper 
hexidecimal number to bg entered is chosen by looking at 
the Appendix and determining the ASQI equivalent you 
desire to generate, or by otherwise detevmirung the 
number which will affect the desired result to the 
operation codes of the disk sector such as BASIC line 
pointers (see generally Part II on disk repair). When a 
number change is made to the hex display, the 
corresponding ASQI symbol will be altered at the 
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position of the cutsot in the ASCII display, If an 
operation code is being generated, its corresponding 
screen display symbol will be displayed in the ASCII 
display as well (if the ASCII numeric equivalent is 
above 127 decimal, a graphics symbol wiE be 
displayed - see you BASIC manual). 

When selecting the ASCII option, you may directly 
enter ASCI symbols into the ASCII display at the 
position of the cursor by pressing the key indicated by 
the fifth column of the Standard ASCII Character Set in 
the Appendix. When the ASCI symbol is generated, the 
symbol's hexidecimal numeric equivalent (see Appendix) 
will be displayed at the corresponding cursor position 
in the hex display. Note that some symbols may only be 
generated by selecting the number option and entering 
the numeric equivalent into the hex display. This is 
because the keyboard is not able to generate these 
characters. These instances are indicated by the phrase 
Hex Input Only in the fifth column of the Appendix. 

When inputting data, you may repeat the last byte 
entered by pressing <ENTER>. This is handy for filling 
or clearing sectors. 



Writing the Zapped Sector Back to Disk 

Once you have made the changes necessary to fix the 
disk, you may write the sector back to the disk. To 
write, press the <BREAK> key. On the command line wfll 
appear the prompt: "Write or return?" By pressing <R> 
you will exit the write command and return to the 
pre-write screen display in the Modify mode. If you 
press <W> the system will prompt "Drive, track, sector?" 
awaiting input of the location to which you wish to 
write the sector, ff you press <BREAK> again you will 
exit back to the File Zap menu. 

You may input in decimal or hexidecimal and you may 
specify any drive, track and sector. Once you have 
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input the numbers and pressed <H^TTER> the system will 
prompt "Do you really wish to write?" Press <Y> to 
write the sector; press any other key to abort the write 
and return to the modify function with the same sector. 
Whenever the system writes to the disk, it verifies the 
write to make sure no errors were made in the transfer. 

Once you have written a sector to the disk you may 
return to the File Zap menu, or back to the Master Menu 
to call up another sector for modification. 



Printing Functions 

The VIP Disk-ZAP provides the opportunity to print 
the contents of your diskfie or transfer the contents 
to another RS-232 compatible device. This is referred 
to as "Printing" a sector, and may be done both from the 
File Zap and the Disk Zap menus. This can be very 
useful for obtaining a hard copy of corrections or data 
you have entered into a disk for inspection, as well as 
for transferring a file to another system for future 
manipulation, such as by using the VIP Terminal. 

<P> Print Sector 

Printing a sector refers both to sending a sector 
to a printer and to transmitting a sector to any other 
RS-232 compatible device. The data will be sent to the 
printer or modem at a default baud rate of 600 baud; you 
may select a different baud rate by using the Set Baud 
Rate function accessible from the File Zap menu, ff a 
baud rate different from the default rate is to be 
selected, it must be done before selecting the Print 
Sector function. 

Before you may select the Print Sector option you 
must have a sector file resident in memory. When you 
are ready to Print, press <P>. When you press the <P> 
key the command line will give the prompt "Output to 
printer or modem?" If you press <P> in response to this 
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prompt, the system wiD, present prompts for sending the 
sector to the printer. H you press <M> the system wiD 
prompt you to send the sector to a modem or other RS-232 
device. 

If you pressed <P> a second time to send the sector ~~ 
to a printer, the system will allow you to choose 
between sending a forty or an eighty character line. 
The system prompts: "40 or 80 characters per line," and 
awaits your input of a <4> or an <8>. The display wiQ 
be sent to the printer when you input either of these. 
Your selection depends on the capabilities of your 
printer (see your printer manual). The printer will 
print the hex display on the left side of the paper 
followed by the ASQI equivalents on the right side of 
the page. Non-printable ASQI graphics or control code 
symbols are printed as periods. You may pause printing 
at any tine by holding the space bar. Resume printing 
by pressing any key except <BREAK>. Pressing <BREAK> at 
any tine will end printing. 

Jf you pressed <M> to send the sector to a modem oi 
other RS-232 compatible device, you will be given two 
options. Your first option is between sending the 
sector in its binary object code or sending it in its 
hex-ASQI format. The system will prompt with "Binary 
or hex ASQI output," to which you may respond with a 
<B> for binary or <H> for hex-ASGtt. The binary form is 
that which would control the computer or is a tokenized 
form of a BASIC program; the hex ASCII form is that 
which could be used to inspect the contents of the 
sector. 

i you choose to send a binary file, once you have 
pressed <B> the file will be sent. If you have chosen 
the hex-ASQI format, the system will again allow you to 
choose whether you desire the hex output in 40 or 80 
character lines. To choose either, press <4> or <8> 
after the prompt "40 or 80 characters per line." When 
you press your selection the system will send the sector 
to the modem. 

28 



<B> Set Baud Rate 

This function allows you to select the proper baud 
rate to use while using the Print Sector function. The 
default baud rate is 600; this feature need only be 
accessed if you desire a different baud rate. The 
VIP Disk-ZAP allows you to choose six different baud 
rates: 110, 300, 600, 1200, 2400 and 4800. When you 
press <B> a menu will appear showing the different rates 
and the corresponding key to press, from <1> to <6>. 
After you have selected the desired baud rate by 
pressing the appropriate key (<ENIER> wiD. select 600 
baud), the system will return to the Fie Zap menu for 
further work. 
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<D> Disk ZAP 

The alternative method for disk repair, other than 
the File Zap function, is the Disk Zap function. This 
alternative allows you to view the disk as a whole and 
make repairs throughout the disk. This alternative is 
particularly helpful for making repairs to the 
directory, which may not be called up as a diskfie 
using File Zap, or for repairing a crashed directory or 
other sector. Disk Zap is selected from the Master Menu 
by pressing <D>. Once selected the Disk Zap menu 
appears awaiting your selection of the appropriate 
command. The Disk Zap menu has the following commands: 

Last Track <E>: Accesses and displays the last 
track of the disk. 

First Track <F>: Accesses and displays the first 
track of the disk. 

Modify Sector <M>: Enters the modify mode to 
modify the sector displayed on the screen. 

Enter Drive <J>: Allows you to specify a 
particular Drive, Track and Sector for 
manipulation. 

Enter Track <T>: Allows you to specify a 

particular Track and Sector on the existing 
Drive for manipulation. 

Locate <L>: WiH allow you to find all 

occurrences of an ASCH or numeric string on 
your disk. 

Print Sector <P>: Allows the current sector to be 
sent to any RS-232 device. 

Set Baud Rate <B>: Elicits a menu for selection 
of the proper baud rate for transmission. 
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Minus 1 Sector <Le£t Arrow>: Moves back one 
sector in the disk. 

Add 1 Sector <Right Arrow>: Moves ahead one 
sector in the disk. 

Minus 1 Track <Up Arrow>: Moves back a single 
track in the disk. 

Add 1 Track <Down Arrow>: Moves ahead one track 
in the disk. 

Exit Disk Zap <BREAK>: Exits from Disk Zap to the 
Master Menu. 

Below the menu is a listing of drive, track and 
sector numbers, listing the numbers of the last sector 
accessed, the LKDEC and ASQI indicators and the prompt 
"Disk Request?" asking for a command from the Disk Zap 
menu. 

Many of the commands in the menu are the same as 
those available from the File Zap menu. This will be 
noted as each is discussed below. The commands in the 
menu will be discussed in a logical order below. 

The first set of related commands are those used to 
access the disk. These include: 1) the Enter Drive and 
Enter Track commands which allow you to call up a 
particular drive, track and sector of a disk and to keep 
track of which track and sector you are working on; 
2) the First and Last Track commands used for easy 
movement to the beginning or end of the disk; 3) the 
Locate command used to find all occurrences of a 
particular string sequentially in the disk; and 4) the 
arrow commands which allow sequential access backward 
and forward of sectors and tracks when accessing a 
sector. 

The second set of commands allow manipulation of 
the disk to be repaired. These commands are all used in 
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the Modify function, and include the ASCII/hex input 
option, the arrow keys used to move the cursor about the 
sector being modified, and the Write command used to 
save the Zapped fie to the disk. 

The third set of commands relate to Printing or 
transmitting a sector. This set includes the Print and 
Set Baud Rate commands. The final function is 
controlled by the <BREAK> command which allows exit from 
the Disk Zap function. 



Disk Access 

Initial disk access is made by using the Enter 
Drive and Enter Track commands. For those with only one 
disk drive or with a desire to use only one disk drive, 
there will be no need to use the Enter Drive command. 
The First Granule and Last Granule commands as well as 
the Locate command will take you to a place to begin 
work. Once the area has been located, you may move 
easily about the disk from that point by using the First 
and Last Track commands and the Left and Right Arrow and 
Up and Down Arrow commands. 



<T> Enter Track 

This command is initiated by pressing <T>. Upon 
pressing <T> the prompt "Track, Sector?" appears below 
the menu on the command line. You may specify the track 
and sector in either the hexidecimal or the decimal 
number system. See the Toggle Base command in the 
discussion of the Master Menu. To access a particular 
track and sector, enter the desired numbers, separated 
by a comma, after the prompt and press <ENTER>. B you 
desire to access theUast track and sector called up, 
press <EN1ER>; if you desire to access a different 
sector in the same track, you need only input a comma to 
indicate the same track and then the sector number. 
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EXAMPLE 1: TRACK, SECTOR? 5,6<ENTER> 
EXAMPLE 2: TRACK, SECTOR? ,8<ENIER> 

In the first example sector six of track five will be 
accessed. In the second example, sector eight of the 
last accessed track, here track five, will be accessed. 

NOTE: It is only when entering the (drivc+, track and 
sector number or when using the Locate command that the 
decimal number system may be used for input. 

When you have entered the numbers of the track and 
sector you desire and pressed <ENTER>, the system will 
locate that sector and display it on the screen. By the 
ASCH display will be the GRAN, DRV, TRK and SEC 
indicators giving your present location, the UXDEC flag, 
and below that a prompt "Disk Request." You may enter 
another command from the Disk Zap menu or you may move 
from there by using the left, right, up and down arrows 
to move around the disk by sector and by track (see the 
discussion of the arrow key functions above in the Fie 
Zap section). Pressing <ENT£R> at any time will exit to 
the Disk Zap menu; pressing <BREAK> will exit to the 
Master Menu. 



<J> Enter Drive 

This command is initiated by pressing <J>. Upon 
pressing <J> the prompt "Drive, Track, Sector?" will 
appear below the menu on the command line. You may 
specify the drive, track and sector in either the 
hexidecimal or the decimal number system. 

As with the Enter Track command, you must enter the 
number of the desired drive, track and sector to be 
accessed, separated by commas, and press <ENTER>. 
Replacing the drive or track number with the comma will 
specify that the same drive and track number as last 
accessed is desired. To access the identical drive, 
track and sector as last accessed press <ENTER>. When 
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you have entered the numbers of the drive, track and 
sector you desire, the system will locate that sector 
and display it on the screen. By the ASQI display will 
be the GRAN, DRV, TRK and SEC indicators giving your 
present location, the UXDEC flag, and below that a 
prompt "Disk Request." You may enter another command 
from the Disk Zap menu or you may move from there by 
using the arrows keys to move around by sector and by 
track. Pressing <ENTER> at any time witt exit to the 
Disk Zap menu; pressing <BREAK> will exit you to the 
Master Menu. 



<E> Last Track 

This command will cause the system to call up the 
first sector of the last track of the disk. Press <E> 
for execution. You may use the Locate and arrow 
commands to continue from there. Press <ENTER> to 
return to the Disk Zap menu. 



<F> First Track 

This command will cause the system to call up the 
first sector of the first track on the disk. Press <F> 
for execution. You may use the Locate and arrow 
commands to continue from there. Press <ENTER> to 
return to the Disk Zap menu. 



Arrow Commands 

These commands are the same as those in the File 
Zap function. Refer to. that section for a discussion of 
them. 
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<L> Locate 

litis command can be of great use to those who wish 
to use the VIP Disk-ZAP to correct just one or two 
mistakes in an assembly language source program, or find 
any occurrence of an ASGI string or a number in a disk 
for that matter. When you press <L> to execute this 
command, the prompt "Locate:" appears on the command 
line below the menu awaiting your input. Input may be 
either in numbers or ASCII, toggled by pressing <CLEAR>. 

When locating numbers, the ASGI flag must be off 
(by pressing <CLEAR», and if a string of numbers is 
being located, each number in the string to be located 
must be separated by a comma. For example, if you 
wished to locate a string with two numbers, 88 and 135, 
you would enter 88,135<ENIER>. 

ASGI strings may be input in uppercase only, or in 
both upper and lower case. Case is originally uppercase 
only and is toggled by pressing <SHIFT> <0>. Note that 
when you are in the lowercase mode using the non-ASCII 
display option (see discussion of screen display above), 
lowercase characters will be represented by punctuation 
and other anomolous symbols. This is due to the 
non-standard character generator chip used by Tandy in 
the Color Computer. 

After you have entered the desired ASCH or number 
string, press <ENTER>. The system will locate the Erst 
occurrence of the string in the disk, display that 
sector in the ASGI display and will stop there with the 
cursor immediately following the string. Below the 
ASCH display is a BYTE indicator which indicates the 
relative location of the last character in the string in 
number of bytes, in the number base you selected, from 
the beginning of the sector. 

On the command line will appear the prompt 
"Continue or Exit?" To continue to the next occurrence 
of the string press <C>. You may continue to the end of 
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the disk and beyond. The VIP Disk-ZAP supports certain 
systems which use tracks beyond the 35th track 
accessible by the standard Color Computer operating 
system. When the program reaches the end of track 35 it 
prompts: "Continue or Exit." Those of you having a 
system using a format of over 35 tracks may continue 
Locating through those files by pressing <C>. Those 
with the standard 35 track format must press <E> to exit 
the Locate function, When you exit the Locate function 
the ASCI display will remain intact and you will be 
prompted: "Disk Request" on the command line. You may 
then proceed to call up any command from the Disk Zap 
menu, such as Modify (if you want the Disk Zap menu 
press <EN1ER>), or press <BREAK> to exit to the Master 
Menu. 

During a Locate, or any read function for that 
matter, the system may encounter a faulty sector. K so 
it will perform a Verify function on the sector to 
determine the nature of the error. For more information 
see the Verify section above. 



Disk Repair Commands 

This section consists of the Modify command and its 
sub-commands. The Modify command and its sub-commands 
in the Disk Zap function are identical to those in the 
Fie Zap function. Please refer to that section for a 
thorough discussion. 



Print Commands 

The print commands consist of the <P> Print Sector 
command and the <B> Set Baud Rate command. These 
commands in the Disk Zap function are identical to those 
in the File Zap function. See that section for a 
thorough discussion. 
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Killing Disk Ffles 

<K> Kill 

This command is used directly from the Master Menu. 
It is used to kill diskfies. When you press <K> a 
prompt "Kill Disk File?" wfll appear on the command line 
below the Master Menu. You must then input the name of 
the diskfie that you desire to kfll, including 
extension and drive number, and press <ENTER>. The 
system win not automatically kfll the file, but wffl 
first seek authorization by prompting "Do you really 
wish to kffl?" Pressing <Y> wffl kffl the file; 
pressing any other key win abort the Kffl and bring 
back the "Request?" prompt for further action from the 
Master Menu. 
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PART II: ZAPPING TECHNIQUES 



Introduction 

With care - extreme care - and luck you should 
never have a need for the VIP Disk-ZAP. All you have 
to do is aJwjLys_ backup the files you are working on, 
both periodically while you are working on them and when 
you are finally done. You also must take special care 
of your entire computer system and your disks. You can 
keep the bus connections on your disk pack plugs clean 
using a large pencil eraser; you keep your disks in 
shape by not using them for second base in a whiffle 
ball game, or a swab for your ketchup. By the way, data 
is stored on the back side of the disk, so avoid 
touching all exposed parts of the disk, especially those 
on the back side. 

Still, even with the utmost of care, your disks can 
become garbled. Your wife could put them into a 
toaster, or, more likely, the operating system could be 
finicky and deconstruct both your master and backup 
disks. Then it's VIP Disk-ZAP time. One word of 
warning, though. Not every crashed disk is repairable; 
some crashes may be caused by defective or damaged 
disks. 

There are generally three types of persons who wfll 
use the VIP Disk-ZAP. The first is the experienced 
machine language programmer. Such a person will know 
most all there is to know about zapping disks, and will 
probably never even read this section. 

The second type. of person is the intermediate to 
experienced BASIC or other high level language 
programmer. This person is constantly using the disk 
system to write programs and is likely to encounter disk 
errors. Since BASIC programs are normally saved to the 
disk in a tokenized machine-language form, correcting 
such files may be difficult without learning some 
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machine language concepts. This manual cannot hope to 
teach those concepts, and instead is devoted to helping 
those who save files in ASCII. (We have, nevertheless, 
provided the curious with a list of the BASIC tokens in 
the appendix. Gook luck]) 

BASIC programmers can save a lot of trouble if, 
instead of saving programs in the usual manner, they 
save the programs in the ASCII format 
(SAVE"filename",A<ENTER> - see your BASIC and Disk 
manuals). You can then make full use of the VIP 
Disk-ZAP without having to learn machine language. 
Added to this is the fact that you can then load the 
program into an editor, such as the VIP Writer, for fast 
and easy editing. 

The third type of person likely to use this program 
is the individual who is not and never wants to be any 
kind of programmer. He or she just wants to fix disks 
to retrieve valuable ASCH files created using some 
utility program such as a word processor, like the the 
VIP Writer. Since recovery and restoration of ASCII 
files is the true purpose of this program, this portion 
of the manual has been written with this person in mind. 
Although we attempt in this part to teach some 
rudimentary concepts of disk repair, we do not promise 
to teach you any but a minimal amount on the subject. 
To become an expert you must read reference works and 
get plenty of experience. 



Disk Structure 

In order to understand disk structure, you must 
understand how numbers are used in many computer 
applications. Often, items in computer applications are 
numbered beginning with zero instead of one. Thus, 
there are 35 tracks to the disk, numbered from to 34. 
A convention has been developed to refer to such a 
counting method which considers as the first number. 
These numbers are referred to as "relative" numbers. 
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Thus, the first track is relative track zero; the 35th 
and last track is relative track 34. This convention 
can be very confusing, so be careful to keep tabs on 
which is being referred to. 

Before beginning to repair a disk you must first 
understand how data is stored on a disk. Chapter 11 of 
your Color Computet Disk System book is devoted to this 
topic and is essential reading. Since Western Digital 
Corporation is the maker of the Disk Controller chip 
which controls your disk drive, you may also turn to 
their publications on the controller chip for some very 
technical explanations. See the following of their 
publications: FP. 17.9X-.02 Flo ppy D isk EfirjmaJtejcZ. 
CBDHolejLjfimiy. and EDJJi2C^J>plJc ajjpn Note,s_. 

In discussing disk structure, we've got to be 
concerned about five categories of disk structure. From 
smallest to largest unit these are: Bytes, Sectors, 
Granules, Tracks and the Directory. 

First off, A byte is a unit of data equivalent to 
one character, such as the letter "Z" or a comma. The 
data you putcon your disk is put there in byte units, 
and the remaining parts of the disk are made up of 
conglomerations of bytes. Of course, a character is not 
put on the disk; instead, the numberic equivalent of a 
character is put there, K you are not storing ASd 
characters, numbers are still stored, but they don't 
equate to characters, but to some token or operation 
code. The numbers ere storee in binary form, that is, 
ones and zeros. Since those are hard for us to read, 
they are converted into hexidecimal (and sometimes 
decimal) numbers for monitor display. Each byte 
contains a combination of eight ones and zeros, allowing 
representation of numbers of up to FF hex (relative 255 
decimal). Each one or zero is a bit, so there are eight 
bits to the byte. 
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A Sector is the next smallest part of disk 
structure. With the Radio Shack Color Computer 
operating system, each sector contains 256 data bytes. 
It is these data bytes you see in the ASCH display when 
using this program. The sector is also surrounded by 
identification bytes used for such things as telling the 
system where this sector is for reading from and writing 
to this sector. These ID bytes, which are set when the 
disk is initially formatted, cannot be displayed on the 
screen, nor can they be zapped using this program. In 
these ID bytes are also bytes used to make sure what was 
being written to the sector got there intact. These 
bytes are called cyclical redundancy check ("CRC) 
bytes. If the sum of these bytes is not what the 
computer expects it to be, i.e., the "checksum" is off, 
a CRC ERROR occurs. More on this later. 

NOTE that since the number of data bytes per sector is 
controlled by the operating system, some operating 
systems have sectors with fewer or more than 256 data 
bytes. 

The next largest unit of disk structure is the 
Granule, but since it is more easily understood after 
you understand what a Track is, the Track will be 
discussed first. With the standard Color Computer 
operating system a disk contains 35 tracks numbered from 
to 34, and each track contains 18 sectors, numbered 
from 1 (not 0) to 18. Each track is surrounded by extra 
bytes for ease of location by the disk drive. (Some 
systems allow use of formats having more than 35 tracks 
per disk, and those systems are also supported by the 
VIP Disk-ZAP.) Of the 35 tracks, 34 are available for 
your files. The other track, track 17, is reserved for 
the directory (discussed below). 

Now to the Granule. A granule is not so much an 
element of disk structure as it is a function of the 
operating system. It is the smallest unit in which 
files may be saved to the disk by the operating system. 
In the Color Computer that size is nine sectors. That 
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is exactly one-half a tiack. Thus, with the 34 tracks 
available (the directory track is not available) for 
your files, there are 68 granules on the standard Color 
Computer disk. The YIP Disk-ZAP contains a GRAN 
indicator on the screen when any disk access is made to 
allow you to keep track of which gran you are in. 

As was said above, Track 17 (11 hex) is set aside 
for system use for the Directory. It contains the 
information the operating system needs to catalog what 
your files are, where they are located on the disk, and 
how much space they occupy. The directory track will be 
the focus of much of your attention when repairing 
disks, so it will be given the most detailed attention 
here. 

Like other tracks, the Directory Track contains 18 
sectors, but only ten are presently used by the 
operating system. The directory can be divided into two 
sections: the file allocation table (more commonly and 
from now on called a granule allocation table - GAT) 
residing in sector 2; and the directory entry section, 
sectors 3 to 11, which are devoted to identification 
information about each of the files stored on the disk. 

Although the GAT sector occurs first in the track, 
it will be more easy to understand if it is discussed 
after the directory entry section. Directory entries 
are each allocated 32 bytes, but only 16 are used. 
Before describing the functions of the various bytes, 
remember that when you are looking at the ASCII display 
you must go into the Modify function to see the numeric 
equivalent for that ASCH symbol. In the Modify 
function, you will be given the hexidecimal numeric 
equivalent of the ASCII symbol in the HiX display in the 
bottom half of the screen. To find the hexidecimal 
equivalent of any particular ASCII symbol, move the 
cursor over that symbol and look at the number at the 
position of the cursor in the HiX display. 
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The first eight bytes, starting from zero, are 
reserved for the filename. The next three bytes are for 
the extension. Note that the "/" used to" separate the 
filename and the extension when you save a fie to disk 
is not stored in the directory. That is because it is a 
command to the operating system to treat the next three 
bytes as an extension. The eleventh byte tells what 
type of fie this is. The binary equivalent, of means 
it is a BASIC program; 1 is a BASK data fie; 2 is a 
machine language program and 3 is a text editor source 
fie. The twelfth byte tells whether the fie is stored 
in ASQI or binary format, for binary and 255 (FF hex) 
for the ASCII format. The thirteenth byte tells the 
relative number of the first granule in the fie. It 
may be from to 67 (43 hex). Bytes 14 and 15 tell the 
relative number of bytes used in the last sector of the 
fie. Since a sector in this operating system may 
contain only 256 bytes, byte 14 will always be 00 and 
byte 15 will give the end-of-fiLe byte unless all 25 6 
bytes are used, in which case byte 14 will be 01 and 
byte 15 will be 00. The remaining 16 bytes in the 
directory entry are reserved for future use. Each of 
the 16 bytes used wiU become of immense importance when 
you desire to reconstruct a directory or a fie. > 

The Granule Allocation Table (GAT) sector contains 
68 bytes of concern to us. Each of these bytes relates 
to each of the granules on your disk, in sequential 
ascending order, from to 67 (43 hex). Thus, byte 
corresponds to granule 0; byte 43 hex (67 decimal) 
corresponds to granule 67. (Remember that the directory 
track, track 17, is not used for data storage, and thus 
is not allocated granules J The contents of these bytes 
corresponding to the granules may contain three 
different types of numbers (in hex): FF, 00 to 43 and 
CO to C9. Look at the hex display of the sector in the 
Modify function to see the numeric value of each 
location. The BYTE indicator will tei you which byte 
(in hex) and thus which granule you are considering. 
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H the byte contains an FF hex (255 decimal), the 
corresponding granule is free and not part of any disk 
fie. E the byte contains any of the numbers from to 
43 hex, this indicates that the corresponding granule is 
part of a disk file, and the number points to the next 
granule in the file. If the byte contains any of the 
numbers from CO to C9 you are told two things. The C 
indicates that this granule is the last granule of a 
disk file. The number, from to 9, indicates the 
number of sectors in the granule that are part of the 
disk fie. Note that to determine the number of bytes 
in use in the last sector you may refer to bytes 14 and 
15 of the directory entry for the file in the directory 
track. 

This abstract explanation has probably floated by 
in several swigs of beer. Let's make it more concrete 
by tracing a hypothetical file named TESTNAME/VIP. When 
sector three of the directory track is called up, the 
name TESTNAMEVIP would occupy the first eleven bytes, 
from to 10. TESTNAME would be the filename and VTP 
(VIP Writer file) would be the extension. Byte eleven 
would tell that this is a data file, byte twelve would 
indicate that it is an ASCII file. The thirteenth byte 
would tell you the relative number of the first granule 
of the file. Here let's assume the number in byte 
thirteen would be 5. With this number you could go to 
the GAT sector (track 17, sector 2), and you would then 
go into the Modify function, You would see both the 
ASCII and HEX displays. Recall that the number obtained 
from byte thirteen was 5. Paying attention to the byte 
indicator, you would move the cursor over the fifth 
byte. 0t is most helpful for granule tracing to have 
selected the hex option from the Master Menu so that the 
BYTE indicator and the HEX display numbers will both be 
in hex.) In the fifth byte would be a number other than 
FF since the granule would be part of the TESTNAME disk 
file. Let's say the number would be 32 (20 hex). This 
number would tell you the next granule in your fie. 
You would then again look in the GAT sector to see what 
granule 32 woujd contain. It would not hold FF hex 

44 



since again it would be part of the disk file. Let's 
say this time that the number in byte 32 would be C3 
hex. This number would indicate that this granule would 
be the last granule of your tie (the Q and that only 
three of the nine sectors in the granule would be part 
of the file. Now you would know the last sector of the 
disk file. To find out the number of bytes in the last 
sector which are part of your file you would have to 
return to sector three of the directory track where the 
directory entry is located and check bytes 15 and 16 
(relative bytes 14 and 15). Bytes 15 and 16 give a 
number which is the number of bytes in the sector, up to 
25 6 decimal, used by your file. You would use this 
number and go to the last sector of your file to find 
the end-of-ffle point, ff only a portion of the sector 
were devoted to your fie, the rest of the sector would 
be filled with garbage. 



One last thing remains for proper handling of the 
granule information: granule to track conversion. This 
is essential to be able to determine from the granule 
number obtained from the directory which track your 
files are on since this program and the disk are 
track-oriented. First, convert the hex number you have 
obtained into decimal for easy manipulation (see decimal 
to hex conversion chart in Appendix). Divide the number 
by two. The result will be used to obtain the track 
number. H the number is less than 17 it is the track 
number; if the result is over 16, add one to the result 
(because the directory track occupies track 17), and 
this is the track number. If the remainder after the 
division is 0, go to the first sector of the track; if 
the remainder is 1, go to the tenth sector of the track. 
To go from track number to granule number reverse this 
procedure. If the track number is under 17, multiply by 
two to get the granule number. If you are concerned 
with sector 10 or beyond of that track, add one to the 
result to get the granule number. If the track number 
is 18 or more, add an additional two to get the granule 
number. Remember to convert the decimal number back to 

45 



hexidecimal if you need to (i.e., you have selected the 
hex number option). 

Now you know just about all you ever wanted to 
about where your fie is on the disk. 



The Operating System 

Your disk system is comprised of hardware and 
firmware. The hardware is the disk drive; the firmware 
is the conglomeration of chips in you controller pack. 
Central to these is the floppy disk formatter/controller 
chip supplied by Western Digital Corporation (see 
above). This chip controls how the disk drive will 
work, and signals if things aren't working right. 

In the controller pack also is Tandy's Color 
Computer operating system program chip. The disk 
operating system is a program supplied by Tandy which 
controls how your files are saved to and read from the 
disk. It determines the diskstructure for its purposes, 
such as the number of tracks, sectors and data bytes, 
and it controls formatting and killing the disk. It 
determines how and where files are placed, and what to 
do if files cannot be read or written. Knowledge of the 
inner workings of the operating system is not necessary 
to repair your disk. Its idiosyncracies should, 
however, be understood for proper comprehension of error 
prompts and for comprehension of the difficulty of 
restoring killed files. 

The Color Computer operating system is fairly 
simple and straightforward. It doesn't offer many of 
the features available with operating systems on more 
expensive computers; yet, this makes the operating 
system less difficult to understand and makes it less 
difficult to repair operating system generated errors. 
The disk controller hardware is supplied by Western 
Digital Corporation. The Western Digital controller 
chip gives specific indications of particular errors 

46 



when they occur. The Tandy operating system does not 
directly use these indications. Instead, it generalises, , > 
the error indications into general error messages. _| 

These operating system error prompts thus may tell you 
very little about what the real error is. Errors are 
discussed in more detail below and this idiosyncracy 
will be discussed more there. 

The second significant idiosyncracy relates to the 
manner in which disk files arc "KILLED". When the Color 
Computer operating system kills a file it places a 00 in 
the first byte of the directory entry, thereby 
eliminating the first letter of the file name. 
Otherwise the directory entry for the file is not 
altered. The real change is done to the granule 
allocation table sector. The operating system places an 
FF in the byte corresponding to the number of each 
granule allocated to the file to tell the system that 
this granule is available for use. (The actual data in 
the respective granule on the disk remains intact, and 
will be overwritten when the granule is next used.) 
This general erasure of the granule allocation 
information makes killed disk files very difficult to 
reconstruct. For more information, consult the section 
below entitled "Retrieving Killed Files." 
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DISK REPAIR 



Introduction 

If you encounter an error while using your disk you 
will know about it since you will either not be able to 
read from or write to the disk. When this happens you 
may have two options. If you are lucky enough to have a 
backup copy of your disk you may be able to backup your 
backup copy using the Backup command from BASIC, fi you 
do not have a backup copy, or your backup copy is also 
crashed or unreliable, you then must consider repair. 
Disk repair requires that you use certain tools and that 
you follow a sequence of tests to determine and then fix 
the error. 

The tools you will need are these: first and 
foremost, one or more formatted disks on which to write 
any files or sectors as may be required; a sharp pencil 
and a notebook to scrupulously record the nature and 
location of any error and to outline the steps for 
repair; and any or all of the following - a pot of 
coffee, your favorite brew, a good dose of patience and 
maybe something handy to smash. 



Errors - Types, Causes and Repairability 

Errors and their correction are at the heart of the 
VIP Disk-ZAP. Thus, a proper diagnosis of the error 
encountered is essential to proper disk repair. There 
are several ways to classify errors. The most essential 
classification is between those repairable and those not 
repairable. Another classification is between "hard" 
and "soft" errors. A third classification is according 
to the error messages that appear on the screen when a 
read or write is blocked because of an error. 

Repairability is a fluid classification. You won't 
always know that something cannot be repaired until you 
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have tried everything and cannot make a repair. 
Sometimes you will know that the error is due to damage 
to the disk and that repair is not worth attempting. 
For example, you dropped your disk on your barbeque 
grill, or spread mayonaise on it. In such cases you 
need only consider whether or not to salvage what you 
can from the disk. 

The "hard/soft" classification refers to errors due 
to disk damage or defect vs. errors due to operating 
system failure. Errors emanating from disk damage or 
defect are usually not repairable. Disk damage includes 
defective manufacture, scratches, creases, spilling 
things on the disk, punctures, or a heavy dose of static 
electricity. Errors emanating from operating system 
failure may or may not be repairable, depending on the 
type of error. 

One cause for operating system error which you 
should always look for is Bad Connections. A bad 
connection between your disk drive and your computer is 
usually caused by dirty connections. It can lead to 
almost any kind of error message since it causes faulty 
reads and writes of all sorts. This is a problem which 
should always be looked for when errors are erratic, and 
different error messages occur when you retry the read 
or write. The fix is with the hardware. First turn off 
your whole system. Next, erase the connecting plugs 
with a large pencil eraser, or jiggle the connectors to 
get a better connection. Now turn on your system to see 
if you still get the errors. If so, try cleaning again. 
If it still continues, and there is nothing wrong with 
your disk, there may be something wrong with your drive, 
disk controller or computer. 

Error Prompts 

When you are Verifying the disk to determine the 
existence and nature of any errors, or you encounter an 
error when performing any other read from or write to 
the disk while using VIP Disk-ZAP, you may be presented 
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with one of several different error messages. These 
error messages, are listed below with most of their 
causes: NOTE: These messages are not supplied by the 
operating system, but derive from the Western Digital 
disk controller chip (the Tandy operating system 
translates almost all of them into the ubiquitous "I/O 
ERROR"). The operating system messages are generalized 
from these and will be of little use in diagnosing 
errors. That's why you purchased this program. 

Error Messages During A Read 

Drive Not Ready: This message has several causes, 
mostly relating to the disk drive somehow not being 
ready to operate. Usually this comes from the drive 
door not being closed or no disk being in the drive. It 
can also be caused, however, by a parity error, by a 
crashed directory, by a defective or damaged disk, or by 
an unformatted disk in the drive. 

Record Not Found: This message indicates that the 
operating system could not find the specified drive, 
track and sector. This could be due to incorrect input 
of the numbers, faulty ID bytes, a crashed directory, or 
a damaged diwk. 

CRC Error: This message indicates that an error has 
been found in the checksum which indicates that the 
sector located has been incorrectly saved by from one 
bit to all 256 bytes. The checksum fault may occur in 
the sector ID bytes or data bytes. This error is the 
easiest to correct. 

Lost Data: This message indicates that the system has 
failed to read ever] byte of data. It is rarely 
encountered, but if it is, try again. If it continues 
to recur, your disk drive may need adjustment. 

Data Request: This message indicates that the system is 
not receiving data for some reason. 
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Bad Data Address Mark: This error occurs when there is 
an error in the sector ID bytes making the sector 
unreadable. 

Bad File: This error occurs on a read only and 
indicates that the directory is faulty. This error will 
be indicated by either an asterisk or an "R" next to a 
file when you call up the directory of your disk, See 
the section on the Directory command in Part I, 

Error Messages During A Write 

Error messages during a write are the same as the 
following during a read: Drive Not Ready, Record Not • 
Found, QIC Error and Lost Data. In addition the 
following error messages occur only during a write: 

Write Protect: This messages indicates that the system 
cannot write to a disk because it is write protected 
with a write protect tab over the slot. Check to see if 
you left the VTP Disk-ZAP master diskette in your drive 
or have put a write protected disk in the drive. 

Data Request: This message indicates that the system is 
not able to send data for some reason. 

Write Fault: This error indicates that the operating 
system or disk system made an error while writing, Try- 
again. H this error message continues, your computer 
system may need readjustment or repair. 



The Fixes 

As you can see, most of the error messages do not 
define the cause of the error encountered or specify the 
method for repair. All the messages indicat-e is what • 
has caused the system to be unable to read or write. 
The errors which are specific are: CRC Error and Write 
Protect. Don't forget that errors may not only be due 
to faulty disks, but may also be due to bad connections 

51 



between your drive, disk controller and computer, or to 
faulty equipment. This problem was discussed above. 

The fixes for all the errors can be divided into 
"automatic" repairs, minor repairs and modifications, 
and disk rebuilding. The latter two can sometimes be 
quite time consuming. Fortunately, by far the most 
often enountered error is the CRC Error, and it is the 
easiest one to correct - nearly automatic. 



Automatic Repairs 

Most errors you will encounter will be repairable 
"automatically". What is meant by "automatic" is that 
the errors can be corrected by rewriting the bad sector 
back to itself. The error messages which can be fixed 
this way are: CRC Error, Drive Not Ready and Record Not 
Found. The CRC Error can usually be fixed this way; the 
others less so. 

CRC errors can have two general causes. Either the 
operating system just made one of its rare mistakes, or 
the disk sector with the CRC error has become "floosy." 
Unfortunately, a sector which is physically bad may not 
always appear bad. Sometimes it may act normal and may 
be written to; other times it will have a CRC error. 
Thus, although this "automatic" repair will be permanent 
for CRC errors caused by the operating system, it will 
not permanently repair CRC errors caused by a floosy 
disk. The proper repair for such a problem is to 
temporarily repair the bad sector, read the file off the 
disk and save it to another part of the disk under a 
different name, and then allocate the bad granule so 
that it cannot be used again (see granule allocation 
below). 

To explain how to make an automatic repair it will 
be assumed that you have verified the disk and found the 
sector(s) containing this error. Using the Disk Zap 
function, use the <T> or <J> command to access the bad 
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sector. When found, go into the Modify function and do 
the following: press <BREAK> to write the sectot to the 
disk, answer the DRV, TRK and SEC prompt with the number 
of the. bad sector and press <ENTER>, answer the "Write 
or return" prompt with a <W>, give the drive, track and 
sector numbers for the write (press <ENTER> for the same 
ones), and answer the prompt "Do you really wish to 
write?" with a <Y> and the sector will be written back 
to the disk just as it is. This should correct the 
sector and you can continue to other errors, if any. 
You should try to read the sector to see if the fix 
worked. 

The Drive Not Ready and Record Not Found errors may 
sometimes also sue comb to this treatment. K this fir 
does not work you will have to try something else. 



Minor Repairs and Modifications 

Minor repairs and modifications cover many 
situations, which could involve your desire to modify a 
file created on one program for use in another program, 
or your need to make a minor correction -to the GAT or 
directory entry sectors. Perhaps you wish to change a 
prompt in a program which you feel is irksome. Just use 
the Locate and Modify sections to find the irksome 
prompt in the program, ZAP a new prompt into place and 
write the sector back to the disk. 

- Reallocating A Granule To Repair An I/O Error 

One particularly helpful minor correction is 
reallocation of a bad granule so that it cannot be used 
by the system. When you save a file to the disk from 
BASIC, if the operating system encounters a sector which 
is physically bad, it will give you an I/O error. 
Everytime you try to save to that disk the same error 
will occur. 
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When this happens, you have to find the bad sector, 
and allocate the granule in which that sector resides so 
that the system will skip it. The way this is done is 
to zap a CO hex into the granule allocation table in the 
position equated with the granule with the bad sector. 
You should recall from the discussion above about the 
GAT sector that the number CO tells the system that this 
granule is the last granule in the file (the "C") and 
that no sectors are being used (the "0"). What this 
does is tell the system that this granule has already 
been used, so the system will skip it; and since it is 
the last one in the file, the system will not look for 
another granule related to it. 

Here's what you do with the disk with the I/O 
error. First use the Verify function to find the bad 
sector. Record the exact location of the bad sector 
(track and sector number and granule number). Next, if 
not already done, convert the number you obtained into 
hexidecimal. The next step is to use the Enter Track 
command from the Disk Zap menu to call up the GAT table 
track 11 hex, sector 2 hex. Go into the Modify mode. 
The cursor will be at relative byte zero, equal to 
granule zero. The BYTE indicator will cue your byte 
location (be sure you have selected the hex input option 
so that the BYTE counter is in hex). Now move the 
cursor in the HEX display until the BYTE indicator is 
the same number as the granule number containing the bad 
sector that you obtained above. Be sure that the ASC 
'flag is not on the screen so that you will be inputting 
into the HEX display (if it is, press <CLEAR». 
Now - zap CO into the byte in the HEX display at the 
position of the cursor and write the zapped GAT sector 
back to the disk. 

Once you have reallocated the bad granule, you will 
again be able to write to and read from the disk. You 
will not, however, be able to backup the disk using the 
BASIC backup command since the sector is still bad. You 
should not, therefore, use this disk for much longer; 
instead you should copy its files to another disk and 
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discard it. H you do desire to backup the disk, you 
may do so with the Read Sectors and Write Sectors 
commands from the Master Menu. Read the following 
section. 

- Backup the Lhbackupable 

At times you will not be able to backup a disk with 
the BASIC backup command, such as when you have to 
reallocate a granule with a bad sector. You may use the 
Read Sectors and Write Sectors commands from the Master 
Menu to backup such a disk, or copy files off a bad 
disk. All you have to do is sequentially read the 
tracks from the bad disk, including the directory track, 
and write them to the same track on a good disk. Be 
sure to copy to the corresponding tracks on the good 
disk so that the directory will be correct! 

When you're done copying, go into the GAT sector 
and de-allocate any granules allocated with a CO because 
of a bad sector. To do this follow the instructions for 
allocation of a granule above except replace the CO with 
an FF hex to tell the system that the granule is 
available. 

- Fixing A Tokenized BASIC File With A Bashed Sector 

BASIC programmers too are subject to the fates. 
Disk sectors can go bad, making a valuable program 
unload able. Lhless you have a backup copy, you may lose 
it. This section will help you recover most of your 
lost program. 

As was mentioned above, BASIC programs are saved in 
a tokenized machine language form in that the BASIC 
commands have numeric equivalents (see BASIC Token chart 
in Appendix). BASIC files have a special format when 
saved. BASIC programs must be loaded to begin in a 
specific place in computer memory. They are stored in 
line units, each line unit pointing to the place in 
emory where the next line is located. Individual 
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program lines also have a set structure. Each He, and 
the Hist line in the file, begins with a 00 byte. 
(This and al future numbers in this discussion are in 
hex unless specified otherwise.) The following two 
bytes point to the location in memory where the next 
line is to begin. Following that arc two bytes giving 
the line number of that line of the program. The 
contents of the program line then follow, terminated 
with a 00. The next line begins with the pointer bytes, 
then the next line number, and so on. The actual 
contents of the program line are tokenized basic 
commands and data strings. 

To illustrate, a short three line program will be 
explained. The first program line "10 PRKT MEM" would 
look like this in memory: 

00 26 09 00 0A 87 FF 93 00 

It is assumed for this example that the starting memory 
location of the program is 2600 (again, all these 
numbers are in hex). The first 00 tells us that this is 
the beginning of the program in the file. This first 
line is nine bytes long. The second and third bytes, 26 
09, are the pointer bytes. They tell the computer to go 
to memory location 2609 to get the next line of the 
program. The next two bytes, 00 0A, are the line 
number, a decimal 10. The next byte, 87, is the 
tokenized form of the PRINT command of BASIC; and the 
next two bytes, FF 93, are the tokenized form of the MEM 
command (for a list of the tokens see the Appendix). 
The final GO tefls the computer that this is the end of 
the line, and that it should consult the previous 
pointer bytes to find the next program line. 

The next program line is: 20 A# = I*JKEY #. This 
is represented in memory as 26 13 00 14 41 24 B3 FF 92 
00. The first byte of this line, 26, is located at 
memory location 26 09. The 26 13 is the pointer, 
telling the computer to go to that location in memory 
for the start of the next line. The 00 14 is the line 
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number (decimal 20); and so on to 00, the end of line ■>■• 
marker. The last line of this little program is: 
30 A = PEEK(O), whose hex display is: 26 IF 00 IE 41 B3 
FF 86 28 30 29 00 00 00 

This last line begins at 26 13 and points to 26 IF. 
Again, there is a line number, and tokenized commands, 
and an end of line 00. 2 you count using all sixteen 
fingers, starting at byte 26 at memory location 26 13, 
you wiU see that the 26 IF points to a 00 and it is 
followed by a 00. This indicates that the file is 
ended. Now you know how to find your way through a 
BASIC fie. 

So what happens when a sector of your valuable 
program is bashed? Well, first, BASIC wifl. not be able 
to read it so you will have to inspect it using the VIP 
Dbk-ZAP. When you look you will probably be able to 
locate the beginning of the line and maybe the pointer, 
but the contents wfll be bashed - maybe the whole sector 
will be garbage. One sector is lost. The object is to 
save what you can of the program so that you don't lose 
it all. . ;m 

The first step is to use the Read and Write Sectors ■ 
command to save the whole program, every sector in every 
granule allocated to it, and the whole directory track, 
to a good disk. Once you have done this, begin the 
operation. Just to tell you now, our goal. will be to 
load the program back into BASIC having the system 
ignore the bashed sector. This will require that you do 
two things. You first must change the pointer in the 
last good sector which originally pointed to the line(s) 
in the bashed sector, so that it now points to the first 
line in the first good sector after the bashed sector. 
Secondly, you must establish a bogus line number at the 
beginning of the bashed sector so the system will load 
it and so you can easily delete the garbage. 

The first task is as simple as it sounds. Go to 
the first good sector prior to the bashed sector and oi 
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look for the last 00 byte before the end of the sector. 
This tells you a line ends there. Since BASIC lines 
must be less than 240 bytes, there has to be at least 
one 00 byte, in every sector. Now look for the beginning 
of that line (which may be in the next sector back). 
When you find it (just after the next previous 00 byte) 
you will be looking at the pointer bytes. Be sure to 
note the contents and location of these. Also note the 
line number from the third and fourth bytes after the 
00. Next, go to the first good sector after the bashed 
sector and do the same thing: locate the first 00 in 
the sector. This ends a bad line which emanates from 
the bashed sector. The two bytes after the 00 are again 
the pointer bytes; the third and fourth bytes are the 
line number. Note this line number. 

Now that you have the line numbers and know where 
the 00's are you can repoint. To repoint you must add 
the number of bytes between the two good lines to the 
number in the pointer bytes of the last good line before 
the bashed sector. Thus, start from the last 00 before 
the bashed sector and count the bytes to the end of the 
sector; next add to this the 256 bytes from the bashed 
sector; finally add the number of bytes from the bashed 
sector to the first byte of the pointer after the first 
00 in the next good sector. Now you have a decimal 
number. Convert it to hex with the chart in the 
appendix and add it, in hex, to the hex number in the 
pointer of the last good line before the bashed sector. 
For addition try: PRINT HEX£ (&H XX XX + &H XX XX), 
where the XX's are your hex numbers. The sum is the 
number to be zapped into the pointer in the last good 
line before the bashed sector. Write this sector back 
to itself to complete the zap. Now, when the program is 
loaded, the system will go from that good line to the 
memory location of the start of the first good line 
after the bashed sector. 

Now only one last thing. Go to the bashed sector, 
and see if you can find a 00 followed by a pointer and 
line number. If so, you need not do any zapping. K 
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not, in the first two byte locations in the bashed 
sector zap in a valid line number and then a 00. To be 
valid, the line number must be greater than the last, 
good line number before the bashed sector and less than 
the next good line number. Check the line numbers you 
noted down to be sure. 

Gnce you have completed these repairs, load the 
program into BASIC. It should load nicely, except that 
the bashed sector should load as garbage. To get rid of 
it, type in the line number you found or zapped into the 
bashed sector and press <ENTER>. When you list the 
program the garbage will be gone. Now all you need do 
is reconstruct the program line and resave the program. 

See how easy it was! 
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Rebuilding Pies, Tracks, Etc. 

All along this manual has been concerned with ASQI 
files. That emphasis is even stronger in this section. 
Reconstructing BASIC files not saved in the ASQI format 
and binary object code files are for the experienced 
only; we cannot hope to teach you how to reconstruct 
binary files. 

Rebuilding files, you should know it now, is REAL 
WORK. It is a last resort when all else has failed and 
you absolutely must have the data stored on the disk. 
The degree to which you will succeed will depend 
primarily on your patience and planning. You will have 
to carefully record contents of sectors and plan how you 
will rebuild your files. 

The primary reason you will ever need to rebuild a 
fie is that somehow .your directory track has been 
altered, either by disk damage, operating system 
failure, or accidental killing of a file. Directory 
failure should be checked whenever you receive the Drive 
Not Ready, File Wot Found or Disk Bad messages or a CRC 
error in the directory, and all other sources for the 
error have been ruled out. The error may be in the GAT 
sector, the directory entry sectors or both. 

To determine where the errors are, go into Disk Zap 
and access track 17, sector 3 (the first directory entry 
sector).. Qf a-. CRC Error occurs, try the CRC fix 
above.) See if it contains any garbage. If all looks 
OK there, continue through to the end of directory entry 
sectors with file entries. If the directory entry 
sectors are OK, and even if the directory sectors are 
filled with junk, go to sector two of track 17, the GAT 
sector, and see if that sector is intact. 

Checking to see if the GAT sector is intact is not 
the easiest thing ever done. Of course, if the whole 
sector is filled with junk, it obviously is bad since 
only the first 68 of the 256 bytes are supposed to have 
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anything but FF's (235 decimal), the rest being orange 
graphics pixels (FF's). 

K there seems to be the correct number of FF's, 
the job becomes more difficult since the other 
characters are ASd representations of the numeric 
equivalents. Go into the modify mode to further check 
the numbers in the byte positions. If the HEX display 
contains any numbers other than FF, 00 to 43 or CO to C9 
(all in hex), some garbage has entered the GAT sector; 
this is also true if the same number, except FF and 
C0-C9, appears in more than one position. 

Once you have determined that the directory has 
been damaged your FIRST task -is to clone your directory 
to either another disk or to a free space on the sariie 
disk. Do this using the Read Sectors and Write Sectors 
commands from the Master Menu. This is done so that you 
can operate on your sick directory without worrying " i " i 
about destroying it forever. 

, , ' ■ ■ - ■ ''■ 

Once the directory is cloned, you must then inspect 
the amount of damage done to the directory. You will 
need to take careful notes to make use of any useful ' 

information about granule allocation that the directory ■""''* 
sectors have to offer. Your task will be to search the 
disk sector by sector, granule by granule to find the 
sectors of your files. Take careful notes'* to keep track 
of the locations of your files and which granules you 
have inspected. You will need to know the exact number 
and location of the sectors, the number of ! granules in 
the files, the number of sectors in the last granule of 
the files, and the number of bytes used by the tie in 
the last sector of the last granule. NOTE: .The 'search 
is made more difficult when you are using an older disk 
since it will probably be quite full, and you will 
probably have killed and replaced many files many times. 
This usually treans that a several granule file will be 
put on granules located all over the disk. 
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Once you have the- search data, your job is to 
either recreate the bashed directory, if it is only 
slightly damaged, or recreate the files on the disk on a 
new disk. To recreate the directory, you must zap the 
pertinent granule, sector and byte information into the 
appropriate GAT and directory positions. 

To recreate the disk files on a new disk, you must 
first have a formatted disk. Then do the following: 

1) From BASIC, or from some other text editor such 
as the VIP Writer, create short, one-line files on the 
formatted disk with, the old file: names to save the 
trouble of zapping in all thpse ifilenames. 

2) Copy the first !o g^anule of the file to the 
granule allocated in the; directory entry. 

3) Zap the number of an- open granule into the 
granule position in the GAT sector of the granule just 
copied to. ,(, v , ; 

4) Copy the next r granule of the file to the 
granule on the new disk the number of which you just 
zapped into the GAT^ctor. 

5) Continue so until you reach, the last granule of 
the file. For the last , granule ZAP a "C plus the 
number of sectors used in the granule into the 
appropriate 'place, in the GAT sector. 

6) Gouht the number of bytes used by the file in 
the last sector and zap this number into relative bytes 
14 and 15 of the, directory entry for the fie. 

7) ff, some of the sectors contain bad data, you 
can correct them by zapping the correct data in place; 
or, if you don't know the correct data, you can replace 
the data with spaces (hex 20) or carriage returns (hex 
OD) for easy detection and repair, 
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It is definitely -going to take experience to master 
the technique of directory repair. Be sure to refer to 
your disk manual and other reference works for all' the 
help you can get. 

Retrieving Killed Files 

Retrieving killed files is a form of rebuilding the 
directory. As was noted above, when a file is killed, 
the operating system does not erase your whole fie; 
instead, it does two things. First, the initial byte of 
the fiHe entry (somewhere on sectors 3 to 11 of track 
17) is changed to .00,- This causes the first character 
of the file name to be changed to 00. Second, the 
system goes to the GAT sector and changes all bytes 
corresponding to the granules' aof the file to FF (those 
nice orange blocks) indicating that those granules are 
not allocated and may be used. The actual data in the 
file granules remains intact on the 'disk until the 
granules are used when you sav'e a new file to the disk. 
Your task will be to change those FF's back to the 
relative numbers of the granules corresponding to the 
granules wherein your* file resides; 3 

The first step is to go to the' file entry in the" 
directory and change the 00 in the first byte back to 
what it was (i.e. , '-reconstitute "yot»r'£i|e' v hame). The 
next step is to go to relative byte* T3 to see .where the 
first granule of your file is, and 1 6 "relative h'yfes 14 '.'..' 
and 15 to see how many bytes' of- the* last sector of the 
last granule of the file are used by the file. Note 

these down. 

. , : , :.:. : , , . i , ;, ',■■■.• •■•'-■'■ 

Now to the GAT sector. 5 your file occupies only 
one granule, the job is easy. Using the number from 
relative byte 13 above, access that granule (remember to 
convert the granule number to the correct track and 
sector number— discussed above) and see how in'aSiy 
sectors are used by that fie. With this information' 
return to the GAT sector and go to 'the byte 
corresponding to the granule which the byte occupies, 
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and ZAP in a "C and the number of sectois occupied by 
the file. That was simple. 

It is where your file occupies more than one 
granule that the problems arise. You may still use the 
granule reference from relative byte 13 of the directory 
entry to find the first granule of the file, but from 
there you must search the disk for the rest of the fie. 
There is a way to find your file on the disk without the 
laborious search techinique, but. this requires that 
there be only one outstanding killed file so that the 
GAT is not absolutely .littered'" 'with FF's. The first aid 
is the limited ability to fiad out the granule length of 
your fie. This may he 'determined 'by looking at the GAT 
sector to see how mariy ,E^s,' are in between other valid 

nf numbers (00-43 and :C0-C9 hex). Count the orange blocks. 
Of'course, your fie could\ have occupied granules after 
the last granules shown as allocated. This makes it 
difficult to ; dct.ermincr«h«r*flu*rtb'et of- granules allocated, 

< since the bytes corresponding to the kill -granules, are, 
c^hangejd* back^ to FF, just:Mc-the rest of "the sectorCr, 

t' r XH^flie second aid involves a more in-depth analysis of 
. .thjeyiaAT sector. By a careful' analysis of |the numbers of 
V ;thjeygranules allocated, preferably by writing them down 
't -on -papej?, you should be able to find some granules in 
, fthe sequence from granule to the last granule 
allocated: that, are not allocated. These are the 
* granules to check first for your fie. ' 

, T . ' .' >' :■:■ ' ' \ i i. '■ 

i 'vl ) X^i) ' f ■• ^ ' ; ■ 

Hi-'I > ; ; : : iQrcc e you. have found the locations of the granules 
. !o<Jdupifed hy the kiBcd file, carefully rebuild the GAT 
' l^e.'ctojr. beginning with the byte corresponding to the 
-.-' number, obtained fromsrelative byte 13 from the directory 
- <rittf\i sRemember, that hyte in the GAT sector must point 
' to" thlr byte corresponding to the next granule of the 
file, and; ?o on'until you come to the byte, corresponding 
'to theilast granule of the file, which muse be zapped 
\vyith Ij^Cj' plus the numbesofJ 'sec tors of the granule 
usied Tay^your file. Then, you ? rse done. You've "unkilled" 
( '-ydutfufieir '-^ W:'!\'\'i> 
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APPENDICES 

'» • ... - - ,il! ..... 

Standard ASCII Character Set ,; i: , 

The standard ASCH character set, below, is 
comprised of the 128 ASCH symbol* from decimal 
through 127. The first column gives.the first 12a ASCH 
symbols in order; the second column gives the display of 
those symbols using the non^ASCII 'option; the third 
column gives the display of. those symbols using the 
ASCH option; the fourth column; .gives the decimal 
numeric equivalent of the, ASCff symbol; column five 
gives the hexadecimal equivalent; and "the final column ' 
explains how to generlaeteMithe ASQtti symbol and its screen 
display equivalent th.roggh,>yourCblpr Gampujter keyboard 
while modifying a sector : uling the ASCft input option. 
You can see that Id federate the ^A^QI'sybbol, you may 
usually either plac« Me htx httrhbter iri^tfte Appropriate 
A oA£ ,on ^ th ? he ^^^*Kr«>j:%^cj£ fji flptifln or s m the 
ASCI option , input a /haracter from/the .keyboard in the 
proper loc a tier uVthe ASCtf dfepiffyt Nore tfiat several 
ASCD synbcls may^not be(2gser> elated 'ffOm the> keyboard in 

It j^ ASai , P Uon » but > K)»y>v<JflJyhk*» inptf* in. hex, in they:- 
Modify mode , ,. , ' 

.' 'i Ij'j j fi joili; i.lt fiv.'O.i ,j- i ;...,; ■■'•: 

ASCIIs NGN-ASC DISflo AS<&r©$SPliAY>™OEe=LHex » ! KEY(S) 
NULL.. INVERSE^, e^^iPS^r^ ^i v i QuHEX CNLY 



ClUVK 

aRL'-fr 

CTRL c 
CTRL D 
CTRL E 
QRL F 
CTRL G 
CTRL H 
CTRL I 
CTRL J 
CTRL K 
ORL L 
CTRL M 
CTRL N 
CTRL O 
CTRL P 
CTRL Q 
ORL R 
C1RL S 
C1RL T 
CTRL U 
CTRL' V'- 
CTRL W 
CTRL X 
CTRL Y 
CTRL Z 
ESCAPE 
FS 



a 

b ; 
c 

•1= 



14 ,« 



i 



,-., m .S| 
INVEftSt 
INVERSE # 
a iio. :s JNYERSE/(| Ui. 

<nir>j « ( d ([INVERSE ^^ 
ail oiNVERSE.<j( bfi.c 
u INVERSE,.),, 

"" ;inver§e'*^ " 

r INVERSE +on - 



3 

; A • > 

■•!•■ 

.-■- :-? < 



m 
n 
o 

' P 

r 

s 

<■>. t 
u 
v 

■■ •• w; 

.1 x^ 
2 



■fi'jj 



* INVERSE v->"< iil2I, 

INVERSE - 13 

. INVERSE f 14 

;l INVERT / ^vfirijijoy 

INVERSH Qisliul A6; 



1 HEX CNLY 
5 1 TEX CNLY 

3 HEX CNLY 

4 !HEX CNLY 

5 HEX.CNLY 

6 HEX CNLY 
'7 HEX^CJNLY 
,8. HEX CNLY 

^HEX CNLY 

' B HEX CNLY 

C KEX.GNLY 

D HEX CNLY 

E HEX CNLY 

-F HEX CNLY 

XiUQ. HEX; CNLY 



INVERSE, hlw< »W.ui\w' HEX CNLY 
- imBBffl^" 1 -'. 8 ,?^-' 1 ^:^ HEX CNLY 
>'v INVERSE 1 ^ IiaiJ H& "M it HEX CNLY 
»dj INVERSE 1 4rij ,is2IOi5i«t3M HBX;CNLY 



: INVERS¥ b ^ 
< J "INVERSE 7 

ih'ulw INVERSE, » 

— Wi4 

'• INVERSE'^ 
INVERSE < 



iqi . 



CNLY 

CNLY 

'23 °17 r 'HEXCNLY 
24 jl${ HEX CNLY 
,25 ■ lft, HEXr CNLY 
# ' lA ifefCNLY 
■W « U0 IBXHEX 3 CNLY 
28 IGjIEXuGNLY 
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APPENDI CBS 

STAttttRD ASCII CHARACTER SET (cont.) ' ' ' 

ASCII NCN-ASC DISp' 'ASC'dISPLAY EEC HEX KEY(S) 

R? ]' J^SE = 29 ' 1DHEXCMLY 

1 1 1 !£K2E > 30 IE HEX CNIY 

^PAPF QPAHi IN £$5S ? 31' 1FHEXCNLY 

SPACE SPACE SPACE 32 20 <SPACE> 

A . . 33 21 <I> 



# :. #; 



i 



■r< 



$ f i V< * 38 26 

( (,;: ; < 



34 22 <"> 

35 23 <#> 

36 24 <*> 
3 7 25 <f > 

<&> 



39 27 <•> 

v -.-, v 40 28 <(> 

i }' ) 41 29 <)> 

<. + ■■->•> Vv i * j 42 2A <*> 

., : •" + i- + 43 2B <+> 

» ■ i r i ,;o ; , 44 2C <,> 

•!.■ ~f-<? 1 " 45 2D <-> 

/ ;•- J?V > ; • 46 > 2E <.> 

? - ° ^ K ; 48; 3,0 <0> 

l! *■« H 1 " 49- 31 <1> 

<2> 

<3> 

[ ;. 4 ,;■■ 52 34 <4> 

<5> 
<d> 

Of cl 7 ; 5.5' M ,37. <7> 

5& ; i 38 <8> 

57:il,19f <9> 

58.H-r.3A <:> 

>. ... iR'H I 5 , 59'M-;3B <;> 

-'2K ,< <°m ii < - 60 ',< , 3C "<" 

-a>> > > ; . : < > \ 62:>> ■ 3E ">" 

$■- r: ®f n p @ i 64' MO «§> 

B > £nr iA ^ 65 i41 <A> 

2 ". °?[! :B f 66 • 42 <B> 

k> r k-n tC ■ 67 - 43 <C> 



i f.") f ' > 2 50 32 

4 ' ; 1 >■;! b 3 >, 51 33. 

2 <;;■. Jior. :- 4 ,;■■ 52 "34 

'2 :- ' iS-M ■ J 5 v; J3T--.V35 

2 •>$;■-• » 6 54; ye 

i •> 7 , .,,, r ) 7 , 55.,, ,, 



g «•■• feiU i 8 , 5& ; i 3i8 

^9 



P- ,'D < 68 -44 <D> 

Enif -| 69 vf45 <E> 

g \\ ^1' -F \ 70 46 <F> 

H av u° v| *V, 71 47i[ <G> 

T <n ? fr ' H 72 4& <H> 

T ^ i ^W J : 73 r 491 <I> 

I /.-C! «\ J-tsi .V.-,-|/-H , 74 ;.4Al <T> 

p. u ■■■■=■? K f-I / .-J-vf-'-'i -75;ri48l <K> 

«»M> ,\:-!:i (.p L • , : i,p /; L,- ;i | 76 IMC <L>. 

Krii .' ..-:-M :''■ 5} v j i-'JiM-Tif < 77>j ! .f 1 yffiH <M> 

..;t .:.»« -r. N \ > wniUfvu ?7-.*^;-r4Bi j. <n> 
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Standa 

ASCII 

: iM ) ;■' " 
0" 

• Pi • - 

,?; 

s 

T 
U 

V 

w 

X 
Y 
Z 



a 
b 
c 
d, 

<'e 
,£- 

$ 

i 
i 

m 
n 
o 

P 

q 

r 
s 
t 
u 
v 
w 

X 

y 

z 



Rubout 



I 



rd ASCII Char a 
NCN-ASC DISP 



; ;> o 

r .1 P 

? 

' St- 

u ' 

y-r 

W" ; 

X -i 

Y 

2 
INVERSE 
INVERSE 
INVERSE 
INVERSE 7 
INVERSE < 
GRAPHICS 
INVERSE I 
INVERSE " 
INVERSE # 
INVERSE i 
INVERSE % 
INVERSE & 
INVERSE ■ 
INVERSE ( 
INVERSE ) 
INVERSE * 
INVERSE + 
INVERSE , 
INVERSE) - 
INVERSE . 
INVERSE / 
INVERSE) 
INVERSE 1 
INVERSE 2 
INVERT 3 
INVERSE 4 
INVERSE 5 
INVERSE) 6 
INVERSE 7 
INVERSE 8 
INVERSE 9 
INVERSE : 

inverse; ; 

INVERSE- < 

inverse; = 

INVERSE^ > 
INVERSE^ ? 



ASC pi SPLAY DEC- HEX 



INVERSE (g 

r 



a 
b 



c 
d 

e 
f 

8 

i 
I 

; 1 

-■' m 
n 
o 

c 

;- q 

:'■': r 
'■ s 



w 



INVERSE r 
?RSE \ 
J R SE ] 

*rse 1 

5RSE < 



79 

80 

81 

82 

83 

84 

85 

86 

87 

88 

89 

90 k 

91,* 

92 

93- 

94 

95 c 

96 

97, 

98 

99 

100' 

101 

102: 

103' 

104 

105 

106 

107 

108 ; 

109 -■ 
110 

1 1 1 < 

112 • 
113" 
114, 
115 : 
116 
117' 
118; 
119* 
120' 
121V 

122 ; 

123 ' 
124 
125 
126 
127 



4F 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
5A 



KEY(S) 

*P> 
<Q> 
<R> 
<S> 
<T> 
<U> 
<V> 
<W> 
<X> 
<Y> 

5B <SFT><T> 
5C <ST>«X> 
5D <SFT><» 
5E <p 

5F <SFT><1> 

60 HEXCNLY 

61 <a> 

62 <B> 

63 <c>, 

64 <d> 

65 <e> 

66 <f> 

67 <g> 

68 <R> 

69 <i> 
6A <j> 
6B <fe> 
6C <1> 
6D <in> 
6E <n> 
6F <o> 

71 <q> 

72 <r> 

73 <s> 

74 <t> 

75 <a> 

76 <v> 

77 <w> 

78 <x> 

79 <y> 
7A <z> 
7B HEX CNLY 
7CHEXCNLY 
7D HEX CNLY 
7E HEX CNLY 
7F HEX CNLY 
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De c imal -Hex i decimal Conversion £har r l 

LLCIMAL HEX 



>: 1 x 1 

: ; * 2 2 

o.f 3 ,/3 

r 4 4 

5 5 

6 6 

7 7 

8 .8 

9 , 9 

10 A 

11 B 
.12 C 
/ 13 D 
; |4 -?E 

.15 «F 

16 ;-i"0 

17 : ;11 
(18 12 

19 13 

■20 (14 

21 U5 

22 fl§ 
2=3 17. 

24 18 

25 a9i 
2g 1A 

27 IB 

28 1Q 
>29 m 
{3 ;1E 

31 IF, 

32 20 
35 21- 

3 4 i*. 

35 23 

36 24 

37 25 

38 26 

39 27 

40 28 

41 29 

42 2A 

43 2B 

44 2C 

45 2D 

46 2E 

47 2F 

48 30 

49 31 
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DECIMAL HBX 


50 


32 


51 


33 


' 52, 


34 


53 


'.:■• 35 


■ T 54 


36 


■"■' 55 


:; 37 


56 


'.' 38 


'■•■ 57 


"'.'! 39 


58 


: V. t 3A 


59 


: : : 3B 


••* 60 


1 3C 


61 


:v; 3D 


62 


:.;;; 3E 


63 


:;; 3F 


64 


':',' 40 


65 


,\',c 41 


} 66 


^?42 


/ ->67 
'-'68 


r -JJ S c 44 


'>69 


^45 


•D 70 


' 46 


■J) 7i 


-';'," 47 


•I>72 


J 48 


CJ73 


M) ;49 


i'-f4 


^- ; , V 4A 


^h 


;1;4B 


"be 


1 1 MC 


H.h 7 


>' r ; s 4D 


0-F8 


I ME 


od 9 


tv^F 


'^80 


V;5o 


■ ii 


:M?5i 


v '-82 


v ;,52 


^83 


-53 


' ; 84 


' ,5 4 


<85 


■ f 55 


'86 


56 


87 


57 


88 


58 


89 


59 


90 


5A 


91 


5B 


92 


5C 


- 93 


5D 


94 


5E 


95 


5F 


96 


60 


97 


61 


98 


62 


99 


63 



DHGIMAL 


HEX 


100 


■ 64 


101 


65 


102 


66 


ol03 


67 


104 -■■- 


68 


105 


69 


106 


6A 


107 


6B 


108 


6C 


109 


6D 


110 


6E 


111 


6F 


112 


70 


113 


71 


114 


72 


115 


73 


116 


74 


117 


75 


1.18 


76 


119 


77 


i2.0 


78 


Ml 


-.79 


112 , 


7A 


<fc23 


7B 


JjZ4 * 


\7C 


HA5 • 


7D 


12,6 


■V7E 


127 


7F 


128 


80 


129 


81 


130 


82 


131 


83 


132 


. 84 


133 


85 


13 4 


86 


135 


87 


136 


88 


137 


89 


138 


8A 


139 


8B 


140 


8C 


141 


8D 


142 


8E 


143 


8F 


144 


90 


145 


91 


146 


92 


147 


93 


148 


94 


149 


95 



APPDNDI CBS 

Dccimal-HexidecifnkT' Conversion Chart (Gont.) 

LEG1MAL PfiX rtci&AL I^X DECIMAL HJX 



150 


"96 


151 


97 


152 


~(i 98 


153 


i 99 


154 


t;; 9A 


155 


9B 


156 


9C 


157 


9D 


158 


9E 


159 


9F 


160 


A0 


161 


Al 


162 


A2 


163 


A3 


164 


A4 


165 


A5 


166 


A6 


167 


A7 


168 


A6 


169 


A9 


170 


AA 


,171 


;ab 


172 


SA£ 


'173 


iflD 


>174 


f AE 


175 


<M 


176 


®d 


177 


¥1 


17-8 


B2 


■179 


bj 


180 


B4 


f 181 


B5 


182 


B6 1 


183 


B7« 


184 


B8 


185 


B9 : 



r^204 



222 


DE 


221 


. DF 


22A, 


E0 


225 


El 


226 


E2 


227 


E3 


228 


E4 


229 


E5 


230 


E6 


231 


E7 


232 


E8 


233 


E9 


234 


; EA 


23 5 
236 


■i 


m 


ED 


238 


EE 


239 


EF 


240 


F0 


241 


Fl 


242 


:F2 


243 


F3 


2-44 


F4 


245 


F5 


246 


F6 


247 


F7 


248 


F8 


249 


F9 


250 


FA 


251 


FB 


252 


FC 


25 3 


FD 


254 


FE 


2'55 


FF 



! P 



f M 
Ml 

'". r i 



'i: V 
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BASIC Keyword Tokfcn Codes 



BASIG' 
DEC VEX KEYWCRD' 1 



'IP 



A 






128 80 
129-81 

130 82 

131 83 
132 
133 
134 



KM 

03 '< 
REM 



84 
85 
86 



ELSE ! 

Ip-i j f. >" 

DATA 
13 5 87 PRINT 
136 88, >CR -.'< 
U7 89 INPUT^ 

138 8A EN3 

139 8B NEXT 

140 8C DIM •', 

141 8D'iiRE^D! • ' 
142' SE WMP\ 

143 -8Ff» RESTCRE 

144 90 RETURN; 

145 91 SlCP '? 

146 92 POKE 

147 93f ;CENT ■ 

148 94%' LI<ST ; '< 

149 95 jCLEAR V< 



-■1^67 ''Ai- 
res A8~ 

169 A9 

170 AA 

171 AB 
172' AC 

173 AD 

174 AE 
175 J AF 

176 BO 

177 Bl 

178 B2 
! I7;? ; B3 
1'80I , B4 



3 !, M5l^l^WE^lBASiC^ 

— r U- 
255+12? 



DEC I«X KEYWaRD EEC ^ » KEYWORD 



^s^+i.z's; 




NOT " 

STEP 

CEF 

PLUS 25 5+132 

MIN0S '2 t 55'+133 ^ .... 

!J ?25 , 5+136 FF+88 

'!. r «,|Jti3 ! 7 FF+89/ 
5 5+13"8 FF+8A 



,',§<& ,'■ 



2554-nt) 
255+13-1 rFF+83 

+85 



ANd : ' 
CR:" 
> 



255+139 FF+8B 
'^55+140' EF+8C 
;'255+:i4i 

s+w 

'■ 255+143 




ABS 
USR 
'RI©., 
SIN 
PEEK 
LEN 
STRjf 

val , ,. 

ASC 

CHR£ 

,ECE 

JYSTK 

LEFTjf 

RGHTf 



150 96) 

151 97 

152 .98 

153 99 

154 9A 
15 5 9B< 
15 6 9C 'SET 1 
1>5 7 -9D RESET 

158 9E CLS 

159 9F NDICR 

160 AO? SCUSD 
161A1 AIDIO 



CSAVE = "i 

OPEN 

CtJOSEn 

LLI5T 




162 A2 

163 A3 

164 A4 

165 A5 

166 A6 



'EXEC 
SKIPF 
TAB 
GOTO 
GOSUB 



l*l.*i > a i JBE| , n \'2^5+ 
18Z''B^ 'EDlt ' '255+1 
T8?"B7 brr FRCN -. ' ,2*3,9+1 44 ^FF+Vo' MIDS" . 

184 BB 'TOXf' 255+145 FF+9T POINT 

185 B9 TJEF 255+14,6 FF +9.2 Jf 
W«? <BA J * EET" 1 "' 555 +147/ ; FF+93- ' ' 
187* W''%mE * i ltt*lU , ;f®-#'&' 

- 1 8 & BG' PCLS* ! . . 2 W+l 49 iFF+^5' ! 
1*9 ! BD'^PSET- !, i 25 5 +150 ; W+9 6 ; ' 

,190 BE' i PRESET-ZS^m FF+9f 

191' BF> 'SCREEN' 255+15 i'FF^S FIX ' 
AR 255+153 FF+99 ,J,CG 

-R^^'+iV^fF'^a :PQs n 
(2JT '2*55415 5 !I ef+?b; iisST 1 ' ' 
PA'fNT' 255.+156 EF+9C Wki 

■ '^S+l^fFF+SD WRFTR 
PUT 25 5+15 8 FF+9E INSTR 
DRAW , ,255+159 ,FF+9F s -TIMER 
PCEPY 2 5 5rtt 60 EF+ftu PPOtt 
PBCDE ' ^S^loi FF+AiSTRft 
PLAY ' ' .-.'T-'-^'V 1 •'• fi ! '' j 

RENLM 

FN 

USING 



192 ,C0 J> 

193 "CI .TQ 
'l^C* 1 ' 

19*5 C3> 

196 C4 ;f 'GET* 

197 C5 

198 C6 

199 C7 
20 f C8 
2-01 C9. 

202 CA 

203 CB 

204 CC 

205 CO 



* The token codes for these BASIC keywords are double 
byte tokens as opposed to the others which are single 
byte tokens. The first byte of the double byte tokens 
is FF hex (255 decimal) and is the least significant 
byte; the second byte is the most significant byte. 
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."-V 3/t ..> i 



How To Use Other VIP Library ^Prpgranw-i ,v 

P Y r^^ h ^ f ^«P^ 8ran ^J^^ h ^.Y IP IJtraryv with the 
f^WW of Vn* Sbeleiancl VB> Du|k-ZAPv wete* X i 
specifically designed to create files compatible with 

jf r P'gMW m < tbe Library,, W£th the library you can 
£?$&?" iW,£f sc P? lal , ho nie fcuspefs tasks and combine - ' 
the rt #5«Hjj,fp.f ffvaf^K purposes, a , n; .■••- 

♦u t-^ 6 ;^^HUr is/ one of' the- central programs in 
th e> , Library, -.,£ contains th«, most , sophisticated editing 



In rF^rT^'ii^H^J^ lt u t ?" be ^ scd to create 
all reports cp^i^fc&es created ,qn pther applical ' 
Library program^- Its .companion u,,the<VIP Speller 



blc 



tT* ■ ci-fll.-fl > '* • jT ^. ""'Vf 1 uv " ^■.incfvu' opener. 
ine\>pell£r.i$ , an^ mdisoensible tool to ; correct: typos , 
and misspellp^ j|a}vF^ library files,.;: ■; [ -cr - - 



AS 



lt£ W -^i4 -{"oMpc^i t° create finjn^al or Mi;, ;;>. ok 
mathematical ^pcift^ . yt contamSjSjp^ticateKi:.print> - ,. 7 
lnT, C ^ s /f^it 1 H^ < i , m n l t PfWgj m P»fh repoits. lYoa I 
P£ff, cr «f t^Wfou? ?M«s by *ht«t ;Vm,Wtjter fac! Eeports; to ! i 
^■ilr^ ? 'K f P-l|jf; ten^and^JIovsipawiOfUM* 0* i K 
tethpl^es, jwtfsj th^t S V|P ^rttcji; for nwet-sn VIP Galc-i rv :■ I 



.rWW^- B ^ ^ omm ?»?atW«SlProgramv;dapable 'of 
mimj&i$V*m am{.jAS€glffl*i including VH>* ■■ t 
^W&V&i&li c?&tM transferred 'Wl the ?v v 
% JP1 Wltf ; :?ditm|^a<{Th«?;iTe«rninal pr6fciam v ) e 

aiso^ow^yt^ f© [HroflffcWM tQUKwk, clubs Ao* \? k. 

tnenc|ss, fpu^an,- a!s<o, ■ pr«i|; istfl^s c«f?ejT?ed fromVotheSs. ^ 



2?™ ' W? CW- #W*( -^ ? * e a tf '35omp^ <{cl it ex n flOd fld a-fcab art 

J VI . W Wfrt^l^^^y^jeHairv.ataity deserted to\ '^; 
$f&*^!vL^W PAlW;?tcSt.sej}rjusi» 5 $he. Color- .TQampwetd f 
diSk operating system Of -emtpe^ jtlptrefortvr^Il S A :;ar 
also work on other Library; fi^^. A; , v OS TlI % ? < A ,,, , 






:xi Mil 



avr fA h -6 r 

oia.) r/. e. f 



i'"!:> 'jjj* x!>iO'W--{3>i ;3i?.An 3?.?. 'h ?o) K'jhoT rrj;lo; :>.;i 
'.ny>!o.S 5I7(! siJHob ^sf' lo :/{d J.'-iR anj" . ?io Aol 'j*' 
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